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Introduction 


With version 7, the web-publishing system 
Drupal stands at that frightening moment 
when it either enters the mainstream or 
falls into the abyss of niche enthusiasts. 
Until now its complexity has kept it mostly 
in the province of technology profession¬ 
als, but I believe Drupal 7 will succeed for 
two reasons: The public is ready for it, and 
it’s ready for the public. 

First, the average web site builder under¬ 
stands—and demands—features that plain 
old HTML can’t offer without extensive pro¬ 
gramming, such as user management and 
form processing. Drupal provides those 
features. Its architecture is elegant, its 
features broad and varied, and its commu¬ 
nity base unparalleled in the open-source 
software world (except by Linux, whose 
lead Drupal trails in terms of contributors). 

But it’s not the only contender, and in fact 
several others are easier to use. Drupal’s 
boosters (Drupolistas) point out that 
their software does well against Joomla 
and other full-featured CMSes (content 
management systems), but I think they’re 
missing the point: The real competition is 


anything that gives people the features 
they want. So for simple personal sites, it’s 
Facebook and MySpace; for businesses, 
Yahoo Merchant Solutions, eBay, and 
Amazon; for publications, WordPress.com 
and Blogger.com; and for the rest, a hosted 
solution like Google Sites. Drupalistas 
would argue that none of these are techni¬ 
cally CMSes. It doesn’t matter—they have 
enough CMS-like features for the masses. 

But time spent learning Drupal rewards 
its student handsomely. None of those 
other solutions compares to it in terms of 
flexibility, security, or support. Learning to 
exploit Drupal’s advantages just takes time 
and attention. 

I wrote this book because I wanted to 
help non-technical people discover the 
joy I found when I started building sites 
in Drupal in late 2007. Freshly down¬ 
loaded, Drupal gave me the ability to run 
a blog (like WordPress) and host polls (like 
MySpace) in addition to everything I could 
do before with plain HTML. Dipping into the 
vast wealth of Drupal extensions (modules) 
gave me plug-and-play access to features 
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I hadn’t even considered before. My first 
Drupai site (savemyhomebook.com) looked 
and functioned far better than anything I’d 
built since learning HTML in the mid-’90s; 
later sites included shopping carts, user 
interaction, and complex data display. 

Which brings us to the second reason 
Drupai 7 is right for non-technical site 
builders: Its developers have focused on 
making it the easiest version of Drupai. In 
early 2009, project founder Dries Buytaert 
made it clear that he wanted “radical 
improvements in usability” to this ver¬ 
sion, even funding design improvements 
through his company, Acquia. Eye-tracking 
studies at the University of Baltimore 
pinpointed items of greatest confusion 
among first-time Drupai administrators, 
and outreach programs encouraged the 
participation of graphic designers and 
user-interface experts. 

The results have fallen short of some of the 
more ambitious goals, but are impressive 
nonetheless. The Drupai community (as the 
saying goes) shot for the sky and missed— 
but landed among the stars. 


Is This Book for You? 

Drupai 7: Visual QuickStart Guide was 
written for anybody who wants to create 
a dynamic, easy-to-update web site that 
looks good and performs well. Unlike most 
current books about Drupai, it’s written for 
anybody with even the most basic com¬ 
puter skills. That means you should be 
already able to: 

■ Use a computer to access the Internet 
through a web browser 

■ Download files 

■ Install software on your computer 


Depending on how you intend to host your 

Drupai web site, you might also need to: 

■ Access a remote computer through 
programs other than a web browser 

■ Navigate by typing on a non-graphical, 
command-line interface such as is 
found in *nix operating systems 

■ Change file permission settings 

■ Understand written instructions from 
your web hosting provider 

What This Book Will Teach You 

By the time you’ve finished this book, you’ll 

have all the skills you need to create an 

attractive and complete Drupai web site. 

Specifically, you’ll learn how to: 

■ Install Drupai on your home computer 
(to prototype your site) 

■ Install Drupai on a remote server (to 
make your site available to the world 
at large) 

■ Give your site its basic identity 

■ Add, change, and delete text and 
images 

■ Modify your site’s visual design 

■ Modify your site’s functional interface, 
for example changing where informa¬ 
tion appears on the page and what links 
show up in menus 

■ Monitor and maintain your site to pre¬ 
vent malicious activity 

■ Make a backup for safety, and restore 
your site from that backup 

■ Allow site visitors to become mem¬ 
bers with their own user names and 
passwords 

■ Control member access 

■ Run interactive features, such as blogs, 
polls, and forums 
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■ Find and add any of hundreds of mod¬ 
ules that extend Drupal with new and 
interesting functions 

■ Find help from experienced Drupal 
administrators when you get stuck 

■ Further your Drupal career by under¬ 
standing and participating in the proj¬ 
ect’s vibrant user community 

What This Book Won't Teach You 

Alas, there are some Drupal-related sub¬ 
jects too big or tangential to include here, 

such as: 

■ Finding and signing up with a web 
host to make your site available to the 
world. (There is a list of companies that 
provide Drupal-ready hosting services 

at drupal.org/hosting.) 

■ Accessing files on, transferring files to, 
or navigating around your remote host’s 
file system. In Chapter 1, “Getting Drupal 
Up and Running,” I briefly show how to 
navigate one of the most common host 
interfaces—the command-line interface 
of*nix. But there’s an enormous varia¬ 
tion in how web hosts operate and what 
they allow their customers to do. If the 
instructions in this book don’t fit, ask the 
support desk of your web host for help. 

■ Registering a domain name or making 
it refer to your Drupal site. Again, your 
web host’s help desk is the best place 
to go. 

■ Suggesting anything about the kind 
of content to put on your site. That’s 
your job! 

■ Programming or advanced theming. 


How This Book 
Is Organized 

Drupal 7: Visual OuickStart Guide is 
intended to take you from a standing start 
to running a web site that’s both functional 
and useful. Because the definition of “use¬ 
ful” varies from person to person, this book 
makes only basic assumptions about what 
you’re going to do with Drupal. The book is 
divided into four sections based on those 
assumptions: 

I Setting Up (Chapters 1 and 2) 

II Managing Content (Chapters 3-6) 

III Managing Drupal (Chapters 7-9) 

IV Appendix and Glossary 

As you can see, the biggest section is 
devoted to creating and managing content: 
That’s probably why you’re learning a con¬ 
tent management system! But this book 
also assumes that you’ll want to: 

■ Open your site to a wider community, 
and therefore need to understand 
Drupal’s user-management features 
(Chapter 7) 

■ Change your site’s appearance 
(Chapter 8) 

■ Take advantage of Drupal’s huge library 
of modules to extend what it can do 
(Chapter 9) 

■ Go beyond this book to interact with 
Drupal’s user community, one of the 
most active in the open-source software 
world (Appendix) 

In making these assumptions—and to best 
use limited space—I’ve left out some of 
Drupal’s finer points. Typically these were 
features that will matter to you only after 
you’ve been administering Drupal sites 
for a while. For example, I decided not to 
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discuss performance or security enhance¬ 
ments, because Drupal’s built-in features 
are sufficient for all but the busiest web 
sites. The appendix, “Getting (and Giving) 
Help,” gives you pointers about where to 
find such information should you need it. 

At times, I use a very simple, fictional 
Drupal site to demonstrate various points. 
If you’d like inspiration from people who 
have taken Drupal much further, see 

drupalsites.net. 

Standards Used In This Book 

I use some conventions to provide guid¬ 
ance. This book: 

■ Uses this font whenever showing 
something that you should actually 
type (also known as code). 

■ Shows the code font in italics to indi¬ 
cate that you should replace the text 
with the equivalent for your situation, 
for example, http-J/domain-name/ 
user /user-id. 

■ Italicizes the first occurrence of words 
that are defined in the glossary. 

■ Refers to locations on your own Drupal 
site in the form http -.//domain-name. 

■ Refers to other web sites in the form 
example.com (without the http://). 

■ Refers to directory paths on your web 
server in the form /path/to/location 
(with a leading slash, which indi¬ 
cates the top directory of your Drupal 
installation). 

■ Assumes that you’re always logged 
in as the superuser (user/l)— that is, 
the user that you created when you 
first installed Drupal. (For details, see 
Chapter 1.) This user has full access to 
every administrative feature in a Drupal 
site. If you get the message “Access 


Denied” when you try to do something 
in this book, try logging out (by going to 

http-J/domain-name/logout) and then 
logging in again (!nttp://domain-name/ 
user). 

■ Gives instructions for Mac first, followed 
by Windows and *nix in those instances 
where differences among them arise. 
(Since you manage Drupal mostly 
through web browsers that work pretty 
much the same on ail platforms, these 
distinctions are rare.) 

■ Provides screen shots of the drupal. 
org web site as it appeared immedi¬ 
ately after its October 2010 renovation. 
In an example of bad timing, the site 
was undergoing profound reorganiza¬ 
tion as we were putting this book to 
bed. Some screen shots you see here 
are of the prerelease beta site, and 
might be different from what you see 
when you visit drupal.org. 

What is Drupal, Anyway? 

Drupal is in the content management 
system (CMS) category of web site tools. 
CMSes excel in letting you create dynamic 
sites, which show different information 
depending on a number of factors, such as 
the input of previous visitors, or whether 
the current visitor is logged in. Sites that 
don’t have such features are called static 
and are typically created using a page- 
description language such as HTML. 

(You can also use Drupal to create sites 
that don’t take advantage of its dynamic 
features.) 

Drupal has many features common to 
CMSes, including: 

■ Administration through a web browser. 
You manage your Drupal site mostly 
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by visiting it in a web browser such as 
Firefox or Safari, logging in as an admin¬ 
istrator, and going to pages that let you 
change site settings. 

A user-management system that lets 
you identify, track, and control visitors’ 
access. 

Fine-grained permissions that allow 
you to grant specific rights to specific 
groups of users. 

Streamlined methods for changing con¬ 
tent. In Drupal, you edit basic pages (or 
other types of content) by clicking a tab 
labeled Edit and filling out a form. To do 
the same thing on a traditional HTML 
site, you’d need to download a file, fig¬ 
ure out what parts to change, make the 
changes, and then upload the file again. 

Flexible methods of displaying content. 
One example is Drupal’s Summary fea¬ 
ture, which shows a shortened version 
of content where appropriate. 

Consistent appearance throughout the 
site. Certain features (such as menus 
and graphic design) remain the same 
regardless of what part of the site you 
visit. 


How Drupal Works 

The best way to understand how Drupal 
works is to compare it with other systems, 
specifically static HTML and hosted sites. 

■ Static HTML sites comprise text files 
that end in .htm or .html; image files 
(.jpg, .gif, .png); other media and 
downloadable files such as Adobe 
Portable Document Format files (.pdf) 
or QuickTime movies (.mov); and any 
custom programming files. These 
reside on a remote computer (the host) 
that’s always on and connected to the 
Internet and that runs a program called 
a web server. 

When someone types the domain 
name of a static HTML site into a web 
browser, the web server finds a file 
called index.html (or index.htm) on 
the host. That file typically contains all 
the text on the site’s home page, along 
with references to other files such as 
images and formatting information. The 
web server gathers all these pieces 
together and sends them back over 
the Internet to the web browser, which 
reassembles them into a web page ©. 


■ Changeable overall appearance. In 
Drupal, you change the look of the 
site as a whole by switching to a new 
theme, hundreds of which are available 
from drupal.org or through private 
designers. The content remains the 
same regardless of what theme you 
select. 

■ Extensibility so you can add features 
by writing (or downloading) a bit of 
programming code, typically in the PHP 
language. Drupal is usually extended 
through the use of modules, which you 
can read about in Chapter 9, “Extending 
Drupal with Modules.” 
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To change a static HTML site, you 
either modify files directly on the 
server or on your personal computer 
and then transfer them to the server 
through a program such as FileZilla 
(filezilla-project.org), Secure Copy 
(SCP), or a web browser-based inter¬ 
face. Likewise, to copy your HTML site 
to another computer, you only need to 
copy its files. 

Hosted sites such as Yahoo Merchant 
Solutions and Google Sites vary widely 
in how they’re set up, but they share 
some common traits. For one thing, you 
almost always build and modify your 
site through a simplified, web browser- 
based interface that hides the underly¬ 
ing HTML and programming code from 
you. As a result, such solutions tend to 
be easy to create but hard or impos¬ 
sible to customize beyond pre-defined 
limits. You neither need to know nor are 
able to know exactly how the site runs 
beyond what you can see through the 
web browser ©• It’s sometimes impos¬ 
sible to copy a hosted site to another 
computer in a useful form—you’re stuck 
with the host for life. 

I 

Site visitor 



© How hosted sites produce 
pages (as far as we know) 


■ Drupal sites essentially comprise three 
parts: the Drupal software itself, which is 
written mostly in the PHP programming 
language; a database that contains your 
site’s content and settings; and images 
and other files. 

When someone visits a Drupal site, 
the web server first finds the index, 
php file. Whereas a static HTML site’s 
index.html file simply describes what 
the page should look like, Drupal’s 
index.php file is a program that causes 
the host to look into dozens of files 
and the content database to determine 
what information should be sent to the 
visitor. When the process is finished, the 
web server responds with files from the 
host and content from the database, 
formatted (mostly) as simple HTML. 

The web server sends that HTML over 
the Internet to the web browser, which 
interprets and displays it just as if it had 
come from a static HTML site ©. 



© How Drupal produces pages 
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Although this process seems impos¬ 
sibly complex to the human eye, the 
host interprets this chain of PHP and 
database instructions quickly and easily. 
Along the way, Drupal has opportunities 
to modify the output based on its own 
programming, modules you’ve installed, 
and any other circumstances. 

You make most changes to a Drupal 
site by manipulating content in the data¬ 
base through a web browser-based 
interface. Except for Chapter 1, this 
book is almost entirely about how to 
use that web browser-based interface. 

To copy a Drupal site to another loca¬ 
tion, you need to transfer both its files 
and its database. You’ll learn how to 
do that in Chapter 2, “Establishing Your 
Drupal Site.” 

Drupal, CSS, PHP, JavaScript, and SQL 

I mentioned that Drupal is mostly written 
in PHP, which was designed specifically 
for web development. Technically, PHP 
is a scripting language, which (among 
other things) means that programs writ¬ 
ten in it are stored in a form that you can 
easily read; an interpreter turns them into 
machine language at the time they’re run. 
(By contrast, programs written in compiled 
languages such as C++ are converted into 
machine language before they’re run, and 
then the computer uses the converted ver¬ 
sion from then on.) As a result, anyone who 
knows PHP can look at the Drupal program 
and understand how it works. 

PHP is a server-side language, meaning 
that all of this interpretation happens on 
the host—typically, on the same remote 
computer that stores the files and sends 
the final HTML code out over the Internet. 

But PHP isn’t the only language involved in 
a Drupal site. Others are: 


■ SQL (Structured Query Language), a 
server-side database language that 
Drupal uses to add, change, and 
remove information. When someone 
posts a page to your site, for example, 
Drupal sends a command in SQL to the 
database that says, “insert this infor¬ 
mation into the node table” (actually, 
Drupal sends several SQL commands). 
When somebody reads that page, Dru¬ 
pal says, “retrieve that information from 
the node table.” Here’s an example. 

INSERT INTO 'node' ('nid', 'vid', 
'type', 'language', 'title', 'uid', 
'status', 'created', 'changed', 
'comment', 'promote', 'moderate', 
'sticky', 'tnid', 'translate') 
VALUES (1, 1, ’page', ”, 'Title 
goes here.', 1, 1, 1257477418, 
1257477418, 0, 0, 0, 0, 0, 0); 

■ CSS (Cascading Style Sheets), a 
descriptive language that defines 
typography, layout, and other display 
properties. One of the fastest ways to 
give your Drupal site the appearance 
you want is to download a free theme 
that has the basic layout you like, and 
then change its CSS files to indicate 
your preferred fonts, colors, and 
images. (You’ll learn how to do this in 
Chapter 8, “Customizing Drupai’s Look 
and Feel.”) 

Unlike SQL and PHP, CSS is a client- 
side language that’s sent over the Inter¬ 
net and then interpreted by site visitors’ 
web browsers. Here’s an example. 

hi, h2, h3, h4, h5, h6 { 
margin: 0; 
padding: 0; 
font-weight: normal; 
font-family: Helvetica, Arial, 
sans-serif; 

} 
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■ JavaScript, a language that mostly 
adds interface “spice” to your site. If an 
image changes when you move your 
mouse over it, that’s JavaScript at work. 
Drupal itself includes several user- 
interface portions of the jQuery library, 
a JavaScript extension that allows 
developers to easily include lots of 
“eye candy,” such as animations, resiz¬ 
able dialog boxes, and drag-and-drop 
effects. 

Like CSS, JavaScript interpretation 
happens in site visitors’ web browsers, 
not on the server. A very small number 
of site visitors turn off JavaScript on 
their browsers and won’t be able to 
see these effects. Fortunately, Drupal 
always tries to present them the same 
information without the effects. Here’s 
some sample JavaScript. 

Drupal.progressBar.prototype. 
startMonitoring = function 
(uri, delay) { 
this.delay = delay; 
this.uri = uri; 
this.sendPing(); 

}; 

You don’t need to learn any of these 
languages to use Drupal! But doing so lets 
you create unique features for your sites 
and improve your overall computer knowl¬ 
edge. Besides, Drupal provides both moti¬ 
vation and opportunity to learn them: Why 
not take advantage of it? I personally had a 
hard time wrapping my head around CSS— 
until I started modifying Drupal themes. 
Likewise, my real first forays into PHP were 
to display information that couldn’t be 
extracted in any other way. 


Having said that, contributed modules 
sometimes take the place of these lan¬ 
guages. For example, the Views module 
(which you can download for free from 

drupal.org/project/views) makes most 
custom SQL programming unnecessary. 

The Long Road to Drupal 7 

Drupal has come a long, long way since 
Belgian student Dries Buytaert started 
creating it in 2000 to stay in touch with 
his friends at the University of Antwerp. 

It received a big publicity boost in 2003 
when supporters of U.S. presidential can¬ 
didate Howard Dean organized campaign 
activities using Drupal 4, and since then it 
has grown by leaps and bounds. 

By the time version 5 arrived in early 
2007, Drupal ran such notable web sites 
as theonion.com and mtv.co.uk, Drupal 6 
came a little over a year later, including 
features that eased installation, mainte¬ 
nance, content translation, and general 
administration. 

Mr. Buytaert listed 11 key improvements 
he wanted when Drupal 7 development 
started in earnest in February 2008 (see 
buytaert.net/starting-to-work-on 
-drupal-7). As I mentioned, the one that 
got the most attention—and that’s most 
visible to anyone who’s tried earlier ver¬ 
sions—is usability. That focus has frankly 
required a change within the community’s 
social structure, as the text-minded devel¬ 
opers who make up its inner circle needed 
to see the value of good visual design and 
user interaction. But with Drupal 7, they’re 
beginning to see the light. They belatedly 
follow in the footsteps of Mr. Buytaert’s 
own conversion, which he described in a 
January 2006 post: 
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“For long I focused, completely and 
utterly, on the aesthetics of Drupal's 
code, neglecting eye candy and 
ease of use... The aesthetics of 
Drupal’s clean code has attracted 
many developers, but has also 
given Drupal the reputation of 
being developer-centric and hard 
to use... I have since learned that 
elegant design and ease of use 
are equally [as] important as clean 
source code.” 

A secondary goal of Drupal 7 was, put 
bluntly, to not repeat certain mistakes of 
the Drupal 6 launch. Three practices have 
given the Drupal 7 release plan a level 
of professionalism that any organization 
would envy: 

■ Drupal development tools are better. 
Testing, communication, and proj¬ 
ect tracking have all benefited from 
advances of the past two years. 

■ Drupal 7’s release schedule was 
defined better. A series of “code 
freezes” set deadlines that both revved 
motivation and imposed discipline. 
While those finish lines moved a few 
times (introducing the giggle-worthy 
phrase “code slush”), and there were 
occasions of blatant disregard for some 
of those deadlines, there’s no denying 
the clarity they attempted to give Dru¬ 
pal 7’s development process. 

■ Support by Drupal module developers 
is better. One of the biggest complaints 
surrounding Drupal 6’s release was 
that most modules—including those 
that nearly every Drupal site admin¬ 
istrator needed—lagged the release 
by months or even years. This time 
around, Moshe Weitzman lobbied for 
developers to pledge release of their 


Drupal 7-compatible modules for 
the same time that Drupal 7 itself is 
released. That effort has garnered over 
100 pledges. Of the 20 most popular 
modules, only six have neither taken 
the pledge nor been incorporated into 
Drupal 7 itself. Even without the pledge, 
Drupal 7 versions of every one of those 
six are in active development. (For 
details, see “Modules: The Drupal 7 
Challenge” in Chapter 9.) 

Drupal 6 vs. Drupal 7 

So what finally came out of the Drupal 
7 sausage grinder? Dozens of changes, 
described in minuscule detail in the peri¬ 
odic release notes linked from the Drupal 
project page at drupal.org/project/ 
drupal. Although you could rightly argue 
about which are the most important, here’s 
my take (summarized from my article on 
the Peachpit Press web site at peachpit. 
com/articles/article.aspx?p=1433049): 

■ New themes. Drupal 7 adds a new 
default theme (Bartik) as well as a sepa¬ 
rate theme, appropriately called Seven, 
that makes administration easier. 

■ Lighter workflow. For version 7, links to 
Drupal’s administrative functions have 
been radically reorganized into what its 
developers hope is a more user-friendly 
configuration, although it might leave 
Drupal 6 administrators scratching their 
heads for a while. Drupal 7 also puts 
commonly used commands in easy 
reach, in the Toolbar and customizable 
Shortcut bar. Finally—and most visibly— 
there’s now an administrative overlay 
that floats controls in front of the screen 
they affect, reducing the feeling that 
you’re navigating through a maze of 
screens. 
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Improved installation and update 
procedures. What probably most often 
tripped up users of Drupal 6 was instal¬ 
lation and updating, both of which 
have been fundamentally improved in 
Drupal 7. First, the installer has some 
nice touches that make it more fool¬ 
proof. Second, help texts during instal¬ 
lation are a lot more, well, helpful. Once 
you have Drupal installed, you can now 
install and update themes and modules 
through Drupal’s web-based interface 
instead of needing access to the server 
(via its sometimes obscure commands). 

Smarter defaults. User studies and 
administrator experience have made 
Drupal more ready for use immediately 
upon installation. You can still override 
such behaviors, but on the whole, Dru¬ 
pal administrators will do a lot less initial 
work to make their Drupal 7 sites work 
the way they want. 

Easier, more flexible content manage¬ 
ment. For a content management sys¬ 
tem, the procedure for entering content 
in Drupal has historically been more 
difficult than it needed to be. But Drupal 
7 makes up for lost time with three 
standout features. First, a neat visual 
trick called “vertical tabs” makes the 
content-entry form cleaner and easier 
to navigate. Second, you no longer 
need to download additional modules 
to put images in content. Finally, you 
can define highly customized types of 
content, for example catalog pages that 
include fields for price, color, and size. 
Before Drupal 7, you needed a module 
called Content Construction Kit (CCK) 
for this functionality. (See Chapter 4, 
“Customizing Content,” for details.) 

Fields in core. Drupal 7 has many 
improvements that are hidden from 


view—unless you’re an experienced 
administrator or Drupal developer. 
“Fields in core” is one of those 
changes, but it has far-reaching benefits 
for everyone who uses Drupal. It essen¬ 
tially lets you break information into 
separate parts ( fields) for truly original 
results. Fields in core actually goes 
beyond content, extending profiles, 
comments, and how you categorize 
content. 

■ Easier programming. As long as I’m 
talking about less-visible improve¬ 
ments, I should mention a huge raft of 
changes that have made programming 
for Drupal easier. The list is far too long 
to include here, but you can see it at 
http://drupal.org/node/22433B and 
http://drupal.org/node/394070. 

■ Clean-up of unneeded bits. Some 
things removed from Drupal 7 include 
the little-used Throttle, Ping, and Blog 
API modules; the “related terms” 
feature for taxonomy (which never did 
anything, anyway); and the ability to 
block posts that don’t have a minimum 
number of words. Of course, every bit 
of obsolete technology has its fans, so 
such removals are always controversial. 
If you find yourself needing those old 
Drupal 6 features, most (if not all) will 
still be available through downloadable 
modules. 

■ Better organization of user permissions. 
Drupal has long offered extremely 
fine-grained permission controls. For 
example, you could allow users to edit 
(but not delete) their own blog entries. 
With that flexibility comes confusion, 
though, and the dozens of check boxes 
on Drupal 6’s default permissions 
screen often threw new administrators 
for a loop. Those permissions have 


xiv Introduction 




been reworked for clarity, and there’s 
a new “administrator” role. 

■ Contextual edit links. When you’re 
logged in as the administrator, a Drupal 
7 site now presents options as you 
hover your pointer over certain items 
you can control. For example: To edit 
a block in Drupal 6, you had to go to 
the Blocks configuration page, guess 
the name of the block you wanted 
to change, and click “configure”; in 
Drupal 7, you just point at the block 
and click. Much better! 
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Getting Drupal Up 
and Runninq 


In this chapter, you’ll perform all the steps 
to install Drupal, the database behind it, 
and all the necessary support software. 

If you’ve never installed server-based soft¬ 
ware before, you might find the procedure 
somewhat more complicated than you’re 
used to, but don’t worry: Although there 
are many steps, each one is fairly simple. 
The procedure includes: 

■ Preparing your computer by installing 
Apache, MySQL, and PHP (an “AMP 
stack”) if needed 

■ Downloading and unpacking the Drupal 
package 

■ Setting up a Drupal database 

■ Running the Drupal installer through 
a web browser 

This section takes you through all four 
steps, both on a development ( staging) 
computer and on the production (site) 
server. When you’re finished, you’ll be 
ready to start adding content, design, 
and functionality to your Drupal site. 


In This Chapter 

Fulfilling Drupal’s Requirements 2 

Downloading and Unpacking Drupal 8 

Creating the MySQL Database Using 

phpMyAdmin 14 

Installing Drupal 17 




Fulfilling Drupal's 
Requirements 

Drupal can run on any Internet-connected 
computer on which you have sufficient 
access permissions to add, delete, and 
change files and directories. You’ll also 
benefit greatly by installing the following 
software, if it’s not already there: 

■ A program to transfer files between 
your Drupal installation and other 
places. An FTP program such as 
FileZilla (filezilla-project.org) is a 
common solution, although other utili¬ 
ties (such as Secure Copy [SCP]) also 
work fine. 

■ A text editor to modify programming, 
design, and configuration files. The free 
programs that come with Mac (TextEdit) 
and Windows (Notepad) are adequate, 
although other editors have advanced 
features that can be useful in Drupal 
development. 

You can meet virtually all the other Dru¬ 
pal software requirements by installing a 
software package called an AMP stock, 
whose name comes from the first letter of 
the three programs it contains: the Apache 
web server, MySQL database program, and 
PHP programming language. 

The downloadable package containing an 
AMP stack for Mac is called MAMP, and 
is available at mamp. info. The Windows 
version (WAMP) is at wampserver.com/ 
en/. (There are several WAMP pack¬ 
ages available: WampServer is the most 
common, and we’ll refer to it simply as 
WAMP throughout this chapter. For a list 
of others, see http: //en. wikipedia. 
org/wiki/Comparison_of_WAMPs.) Many 
*nix servers—that is, those running Unix, 
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Linux, or another Unix-like operating 
system—come with Apache, MySQL, and 
PHP configured and running; procedures 
for installing an AMP stack on those *nix 
servers that don’t have one vary greatly. So 
we won’t discuss installation of these pro¬ 
grams in such environments in any detail, 
beyond the sidebar later in this chapter, 
“What about *nix Operating Systems?” 

<ZD I strongly recommend that you develop 
your Drupal site on a local computer—that is, a 
laptop or desktop machine. Then, when you’re 
ready to launch, move your site to a server. 
(We’ll show you how to do that in Chapter 2, 
“Establishing Your Drupal Site,” in the section 
“To move your Drupal site to another com¬ 
puter.”) Working on a local computer is gener¬ 
ally faster, because you’re not affected by 
Internet slowdowns. It’s also easier, because 
you can manage files through your computer’s 
familiar desktop interface. 

QD It’s possible to run Drupal using other 
web servers and database servers, but the 
Apache/MySQL combination is by far the most 
popular: We’ll assume you’re using that pairing 
throughout this book. 

GD PHP is always required, as Drupal is 
technically a collection of PHP scripts. 


But I Want to Do This the Easy Way! 

The next few pages tell you how to download and install both an AMP stack and Drupal itself, 
for either Mac or Windows. But there’s actually a single package that includes both: The Acquia 
Drupal stack installer, DAMP, available from acquia.com/downloads. DAMP also includes several 
additional Drupal modules and themes, as the sidebar “Understanding Acquia Drupal” describes. 

So why bother installing the pieces separately? First, so you gain experience in customizing and 
troubleshooting your installation; and second, to help you install Drupal in places where DAMP 
won’t work, such as on most *nix operating systems or on a pre-10.5 version of Mac OS X. But if 
you don’t have such needs and are comfortable using Acquia Drupal, the Acquia Drupal stack 
installer is the faster option. 
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To install MAMP on a Mac: 

1. Visit mamp. info in a web browser. 

2. Click “Download now.” 

MAMP is the free version; the 
mamp.info site also offers a commer¬ 
cial version (MAMP Pro) with additional 
features that aren’t necessary for run¬ 
ning Drupal. 

3. Click the latest version of MAMP to 
download the file ©. The file is quite 
large, so downloading may take several 
minutes. 

4. Find the downloaded file: It’s probably 
either on the Desktop or in /Users/ 
your-username/Dovmloads, and has a 
name ending in .dmg.zip. 

5. Double-click the file to uncompress it. 
The result is a file ending in .dmg ©. 
You may now discard the .dmg.zip file. 

6 . Double-click the .dmg file. Read through 
the license agreement that appears © 
and click Agree to accept it. 



Download now . 


MAMP: One-click-solution for 
setting up your personal Webserver 


© The link to 
download MAMP 



© The compressed .dmg.zip file and the 
uncompressed .dmg file 



© The license agreement you must accept to 
install MAMP 
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O The window that opens after you agree to 
MAM P’s licensing terms 


7. A disk appears on your Desktop, and a 
window opens with instructions on how 
to complete the installation ©• 

8 . Drag the MAMP folder into the Appli¬ 
cations folder alias as the instructions 
direct. 

9. MAMP is now installed. To start it, go to 
/Applications/MAMP and double-click 
the MAMP icon. 

GD A default setting in MAMP often causes 
problems when you later try to install Drupal. 
To fix it, open the file at /Applications/ 
MAMP/conf/php5/php. ini with a text editor. 
Search for the line that reads memory_limit 
= 32M and change the value to at least 64M 
(that is, so it reads memory_limit = 64M), 
then restart MAMP. 

lUf When you first start MAMP, it will make 
some assumptions about how you want to run 
the web and MySQL servers—specifically, what 
ports to use, and where files will be located. 
We’ll show you how to change those settings 
to work with your Drupal installation in the 
section “To Configure MAMP for Drupal on 
a Mac.” 

GD As in *nix systems, MySQL installs an 
initial user named root that has superuser 
powers to do pretty much everything to 
MySQL databases. When you install MAMP, 
the default password for that superuser is 
also root. If you intend to use your Mac as a 
public-facing server, or simply want to make 
the MAMP installation more secure, change 
the password by opening the Terminal pro¬ 
gram found at/Applications/Utilities/ 
Terminal and typing /Applications/ 
MAMP/Library/bin/mysqladmin -u root 
-p password newpassword. Then enter the 
former password to confirm the change. 
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To install WAMP on a 
Windows computer: 

1. Visitwampserver.com/en/inaweb 

browser. 

2. Click the link “Download the latest 
release of Wampserver 2” ©. 

3. On the resulting page, click the Down¬ 
load link. This page also specifies which 
versions of PHP and MySQL are part of 
the package Q. 

A web page on sourceforge. net dis¬ 
plays, and the file automatically starts 
downloading to your browser’s default 
download location (usually the Desk¬ 
top). The file is large, so downloading 
may take a few minutes. 

4. Once downloaded, double-click the 
file 0. You might see a dialog that 
gives special instructions for upgrad¬ 
ing from a previous version. Assuming 
that you’re not upgrading, click Yes to 
continue the installation. 

5. The WAMP Setup Wizard appears ©. 
Complete the necessary steps, accept¬ 
ing the license agreement and selecting 
preferred options as you go. By default, 
WAMP installs on the primary drive, as 
c:\wamp. 



©The link on wampserver.com that leads to the 
page containing the downloadable file 


© The link that 
actually downloads 
the necessary file 




0 Icon to install WAMP 



©WAMP Setup Wizard 
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O The WAMP icon in the system tray 



O Starting WAMP from the system tray 


6 . WAMP is now installed. To start it, click 
its icon—which looks like a parking 
meter ©—in the system tray and select 
Put Online O- 

<Q> As in *nix systems, MySQL installs an 
initial user named root that has superuser 
powers to do pretty much everything to 
MySQL databases. When you install WAMP, 
that superuser has no password by default. 

If you intend to use your Windows computer 
as a public-facing server, or simply want to 
make the WAMP installation more secure, 
create a password by following instructions 
found at udopage.com/developers/ 
setting-up-passwords-for-wamp.php. 


What about *nix Operating Systems? 

Many Drupal administrators develop their sites on a computer running the Mac or Windows 
operating system, then move them to managed, remote servers running some flavor of’nix. 

These servers almost always already have an AMP stack installed and running: Without them, 
they couldn’t support a web hosting business! 

But what if you want to develop on a *nix computer that’s not running an AMP stack? 

If you’re running the Ubuntu or Debian distribution, you can use the Acquia Drupal .deb pack¬ 
age available from acquia. com/downloads. (It includes Acquia Drupal as well as an AMP stack: 
See the sidebar “Understanding Acquia Drupal” for details.) Otherwise, the best solution is 
to install the AMP stack that’s specific to your operating system’s distribution, using its native 
package manager. See your operating system’s documentation for more information. A second 
option is the one-size-fits-ali solution XAMPP, which is available for a variety of platforms at 
apachefriends.org/en/xampp.html. Note that XAMPP’s developers state that the default con¬ 
figuration is not secure enough for a production environment. However, it’s both appropriate and 
fitting for developing a site that will later be moved to a secured server, and can itself be hardened 
(made more secure) by following instructions on the XAMPP web site. 
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Downloading and 
Unpacking Drupal 

Once you have an AMP stack running, the 
next step is to download and unpack the 
Drupal package, and configure your AMP 
stack so it knows where Drupal is installed. 

To download Drupal to a Mac 
or Windows computer: 

1. Visit drupal.org in a web browser. 
There are several links that lead to 
the free, downloadable Drupal pack¬ 
age, for example the “Drupal core” 
link in the right column. I prefer to go 
directly to the Drupal project’s page at 
drupal.org/project/drupal. 

2. Follow the “download” links until you 
find the latest version of Drupal 7 that 
doesn’t end in “-dev.” (Those are devel¬ 
opment versions, intended more for 
programmers than site administrators.) 

3. Find the downloaded file, which will 
have a name similar to drupal-7.0.tar.gz, 
and double-click it to uncompress it. 
The result is a folder containing all the 
files you need to run Drupal ©. 

GD You can rename your Drupal folder to 
anything you want, as long as your operating 
system and AMP stack allow it. (Don’t use any 
names with periods in them.) 

GD Should you decide to change where 
you installed Drupal, move the entire folder. 
The Drupal installation contains a “hidden” 
file (. htaccess) that doesn’t show up in the 
Finder on Mac OS X and therefore won’t be 
copied if you simply select the folder’s con¬ 
tents and move them elsewhere. 



© Drupal, after expanding the downloaded file 

Help! I Can't 
Uncompress the File! 

Drupal comes as a compressed archive 
in the gzip format, which many versions 
of Windows don’t understand without a 
helper application. Some programs that 
will let you uncompress gzip files include: 

■ Winlmp (technelysium.com.au/ 
winimp.html) 

■ Stufflt Expander (stuffit.com/ 
win - expander. html) 

■ WinAce (winace.com) 

■ WinZip (winzip.com) 

Some of these programs require pay¬ 
ment, while others require you to join the 
company’s marketing email list. If you 
don’t like any of them, you can always 
just install Drupal using the Acquia 
Drupal stack installer for Windows 
(DAMP), which comes as a Windows 
executable file (.exe): See the sidebar 
“But I Want to Do This the Easy Way!” 
earlier in this chapter for details. 
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O Turning off Web Sharing 



© The MAMP icon 



O The MAMP application 


To configure MAMP for 
Drupal on a Mac: 

1. Mac OS X Web Sharing could cause 
conflicts with MAMP. To turn it off, 
choose Apple menu > System Pref¬ 
erences, click the Sharing icon, and 
ensure that the Web Sharing check 
box is not selected ©. 

2 . If MAMP isn’t already running, start it by 
double-clicking the MAMP icon in the 
/Applications/MAMP folder ©. If you 
see a dialog box that warns you about 
MAMP being an application down¬ 
loaded from the Internet, click Open. 

Two things happen: The MAMP applica¬ 
tion launches ©, and a browser window 
opens with further information about 
both MAMP and your site. For now, 
ignore the browser window to focus 
only on the application, as that’s where 
all the server-configuration settings are. 

3 . Click the Preferences button. A dialog 
box with four tabs opens: Start/Stop, 
Ports, PHP, and Apache. 

4 . Click the Apache tab ©. 

continues on next page 



© MAMP’s preferences dialog box, with the 
Apache tab selected, before choosing the new 
Drupal location 
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5 . Click Select, navigate to the location of 
your Drupal folder, and click Open Q. In 
the example, we’ve renamed our Drupal 
folder drupalvqs-site and moved it to 
the /Users /username /Sites folder. 

6. Recommended: In MAMP, click Prefer¬ 
ences, click the Ports tab, then click 
“Set to default Apache and MySQL 
ports” © You’ll need to enter your 
Mac OS X password when you start or 
stop the servers. However, if you leave 
the ports on their default MAMP set¬ 
tings, you’ll need to type : 8888 at the 
end of every URL on your site, which 
can be much more intrusive. 

GD The folder that serves documents to the 
web through Apache Is called DocumentRoot 
or (colloquially) docroot. 

<2D By default, MAMP sets DocumentRoot 
as /Applications/MAMP/htdocs, a folder 
inside the MAMP application itself. I recom¬ 
mend changing the DocumentRoot because 
most backup programs ignore the enormous 
Applications folder, which means you’re 
likely to lose all your Drupal files if your hard 
drive fails. 

GD I prefer to use the Sites folder as my 
DocumentRoot, which is set up for just this 
purpose—and then make sure my backup 
program knows to look there. The Documents 
folder is also a good candidate, because most 
backup programs save files that are in there 
by default. 



Q Showing Apache where to find your Drupal 
installation 



© Changing Apache and MySQL ports in MAMP 


Couldn't I Just Use Mac OS X's 
Built-In Unix Programs? 

Mac OS X is a Unix-based system, so you 
might be tempted to just tie together its 
Apache, SQLite (or downloaded MySQL), 
and PHP parts to create your own AMP 
stack. Unfortunately, doing so can inter¬ 
fere with Mac OS X’s Web Sharing and 
other systems. It can be done; but in my 
(somewhat painful) experience, MAMP is 
by far the easier way to go. 
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o Opening WAMP’s httpd.conf configuration file 
in Notepad 



O Opening WAMP’s php. ini configuration file in 
Notepad 


To configure WAMP for Drupal 
on a Windows computer: 

1. Click the WAMP icon in the system tray, 
then choose Apache > httpd.conf © 

The httpd. conf file opens in Notepad. 

2 . Edit the line that begins with 
DocumentRoot to reflect where you 
put your Drupal files. This is the 
DocumentRoot, which by default is 

c:/wamp/bin/apache/apacbe-version 
-number. I recommend that you change 
that to somewhere you’re sure your 
backup software will see it. The My 
Documents folder is a good choice. 

3 . By default, WAMP’s PHP settings limit 
file uploads to be no larger than a paltry 
2 MB, which will cause problems when 
you try to run Drupal. Change it by click¬ 
ing the WAMP icon in the system tray, 
then choosing PHP > php.ini O. In the 
file that opens in Notepad, change the 
upload_max_filesize line to a larger 
number; I recommend at least 64 MB. 

To transfer Drupal to a *nix server: 

Now that you have the downloaded Drupal 
package on your local machine, you need 
to move it to your server, using one of 
several methods: 

■ Use a graphical file transfer protocol 
(FTP) program, such as Cyberduck 
for Mac (cyberduck, ch), WinSCP for 
Windows (winscp.net), or FileZilla for 
both platforms (filezilla-project. 
org). These programs all have familiar 
drag-and-drop interfaces. 

continues on next page 
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■ Use a text-based terminal program: 

One included with Mac OS X is at 
/Applications/Utilities/Terminal; 
on Windows, choose Start menu > Run, 
then type cmd. Connect to your *nix 
server by either typing telnet user@ 
domain-name or ssh user&domain - name 
© Then navigate to the directory 
where you want to install Drupal and 
type wget URL-to-drupal-package. 

For the Drupal 7.0 version, for example, 
that’s wget http://ftp.drupal.org/ 
files/projects/drupal-7.O.tar.gz. 
(Table 1.1 lists some useful *nix com¬ 
mands, and o shows a sample *nix 
navigation session.) 

You are now ready to unpack the Drupal 
package. 

To unpack Drupal on a *nix server: 

1. Navigate to the directory where you 
downloaded Drupal. 

2. Type tar -xzf name-of-file. If 

you want to see a list of files as 
they’re being unpacked, type 

tar -xzvf name-of-file instead. 

Drupal is now installed in a newly 
created directory at the same level 
as the .tar.gz file. 

3. Optional: Delete the downloaded 
package by typing rm name-of-file. 

4. Optional: Rename the Drupal directory 
using the mv command, for example, 

mv drupal-7.0 drupalvqs-site. 

GD Most *nix systems can complete file¬ 
names automatically: Just type the first few 
letters of your downloaded file, then press Tab 
and "nix will fill in the rest—as long as there’s 
no other item in that directory that starts with 
the same few letters. 


ft O O tgpl|pr@wph41:-ssh —67x1 S 

ip-91-132:- tomgcllcr) 33h tgclIcrf3drupalvq3.com 
tx)p! 11 ftrftriri ipn I vqs .ma's password: 

Last loqtn: Tue Sep 28 11:16:87 2818 fro« 132.162.94.132 
[tgelIer8veb41 -]$ | 


I 

I 


O Using ssh to connect to a *nix server 


M ^ ^ tqeller@web 41 :~/downloads — ssh — 66 x 15 

[toe I ler&>eb41 ~]J pvd 
/home/tgeller 

ImUmMI ~]$ Is 

bock 14 x 5 certificates docs keys logs wbapps 

hin rrnn.php rinunlnmfe lih tnp 

[lyel leidwetrll ~]$ cd ikmiluuds/ 

[t.o*11erflweMI downloads]) Is -el 
luluI 12 

drwYrwrr-Y 7 tgel ler trjeller 4fW6 ?>p TfVl 8 . 

(Jiwxi-x-♦ 13 lyel lei lye I lei 4896 Dec 18 2889 .. 

[tylllrtnibll downloads]) | 


O Navigating in 
typed by the user 

nix; the parts after the “$” were 

TABLE 1.1 *nix Commands 

*nix Command 

What it Does 

pwd 

Shows your current location 

Is 

Lists items in your current 
location, in a basic format 

Is -al 

Lists all items, including 
invisible ones, with attributes 

mv source 

destination 

Changes the location and/or 
name of a file or directory 

cd directory- 
name 

Moves into a directory that’s 
at the same level as your 
current location 

cd .. 

Moves to the directory one 
level up 

cd /path/to/ 
location 

Moves to a specific location 
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Understanding *nix Commands 

*nix has notoriously obscure commands, and its text-only interface can be daunting if you’ve only 
ever used Windows or Mac OS X. But it packs a real wallop into just a few keystrokes, so learning 
a little *nix is well worth the time. 

Some commands stand by themselves, such as pwd (which originally stood for “print working direc¬ 
tory"). Most have additional options: Is -al means “list all files (including invisible ones) in a long 
format.” Some require additional parts. For example, cp (copy) requires a source and destination, 
such as cp original . txt copy. txt. 

For detailed help using a specific command, type man command. Help in another form is sometimes 
available by typing info command, and you might find abbreviated help by typing command - -help. 
To find a command based on its description, type apropos description. (For example, 
apropos copy returns a list of several commands, including cp.) Not every command works on 
every version of *nix. 

*nix’s interface also employs dozens of shortcuts, such as the double period that means “the 
directory one level above where I am now.” For a guide to some of them, check out the book 
Unix: Visual QuickStart Guide, 4th Edition (Peachpit Press, 2009). 


Understanding Acquia Drupal 

Until September 2008, general-purpose Drupal was mostly available only in one configuration, 
from drupal. org. That all changed when Acquia (acquia. com), a company co-founded by Drupal 
originator Dries Buytaert, released a commercially supported version called Acquia Drupal. It’s a 
superset of the Drupal project’s core Drupal with additional modules that (among other things): 

■ Open a communication channel between your installation of Drupal and Acquia’s monitoring, 
search, and other services 

■ Make administration easier 

■ Improve support for graphics 

■ Give site visitors additional capabilities 

■ Permit construction and display of complex content structures 

■ Support other contributed modules 

Acquia Drupal also includes some additional themes (graphical skins) for Drupal. Like the core 
Drupal distribution, Acquia Drupal is free and open-source software, and is made available under 
the GNU Public License. 

To download Acquia Drupal, go to acquia. com/downloads; for more details on its contents, see 

acquia.com/products-services/acquia-drupal. 

This book assumes you’re using core Drupal unless otherwise specified. 
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Creating the MySQL 
Database Using 
phpMyAdmin 

The Drupal files themselves don’t contain 
any of the posts, comments, or settings 
of your web site. Instead, all text-based 
content passes through Drupal into a 
database, and Drupal retrieves that con¬ 
tent from the database when requested. 

In fact, you could say that Drupal is only an 
attractive and convenient front end to that 
database; remove the database, and the 
site disappears. 

Drupal can connect with databases in virtu¬ 
ally any database program, but by far the 
most commonly used one is MySQL. The 
easiest way to manage a MySQL database 
is through the free program phpMyAdmin, 
which is part of both MAMP and WAMP 
installations. 
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~ MAMP 


MAMP 

manage your website locally 

( Test MAMP pro ) 


( Stop Servers ) 

00 Aparhp Server 
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( Preferences... _) 

( Q uit ~ ) 


O Launching MAMP’s start page in a web browser 




O The link that leads to the phpMyAdmin screen 


To create Drupal's database 
on Mac OS X using MAMP: 

1. If MAMP isn’t already running, start it by 
double-clicking the MAMP icon in the 

/Applications/MAMP folder. 

2. In the main MAMP screen, click the 
“Open start page” button © to open 
a page in your browser window. 

3. On the resulting web page, click the 
phpMyAdmin link ©. 

4. On the phpMyAdmin screen, type 
a name for your database in the 
“Create new database” text box and 
click Create ©. In our example, we 
named the database drupalvqsdb. 

A screen appears with the notice 
“Database drupalvqsdb has been 
created.” 



© Creating a Drupal database named 

drupalvqsdb 


HU To be safe, use no more than 16 charac¬ 
ters for your database name. Database names 
might be case-sensitive, depending on the 
operating system. Most characters are permit¬ 
ted, although you should avoid underscores 
and quotation marks in all their forms. Keep it 
simple by using only lowercase letters. 

GD Remember your database name! You’ll 
need it to install Drupal. If you ever need a 
reminder, relaunch the phpMyAdmin screen 
and click the Databases tab at the top. 
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To create Drupal's database 
on Windows using WAMP: 

1. Click the WAMP icon in the system tray 
and choose phpMyAdmin ©• 

2. On the phpMyAdmin screen, type 
a name for your database in the 
“Create new database” text box and 
click Create ©. In our example, we 
named the database drupalvqsdb. 

A screen appears with the notice 
“Database drupalvqsdb has been 
created.” 

To create Drupal's database on *nix 
using the command-line interface: 

1. Type mysqladmin -u root -p create 
database-name. Follow the prompts to 
complete the process. 

2. If you get the response mysqladmin: 
command not found, you’ll need to 
locate the mysqladmin application on 
your *nix computer in one of the follow¬ 
ing ways: 

► Typing which mysqladmin 

► Typing locate mysqladmin 

► Typing find / -name mysqladmin 

You might have to find the correct 
instance of mysqladmin from among a 
long list. 

GD Many Internet service providers don’t 
give you direct access to MySQL tools, and 
instead require you to create databases 
through web-based interfaces such as 
phpMyAdmin. Contact your service provider 
if you have any problems with this step. 



© Launching the MySQL control program, 
phpMyAdmin 


MySOL localhost 

tfc Create new database (T) 

[dmpalvqsdbl |Collabon H Create 

MySfJl rnnnertinn rollatinn | uttlJ_qenerol_ci 3 ® 

© Creating a Drupal database named 

drupalvqsdb 
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Installing Drupal 

After all you went through to prepare your 
computer, you’ll be happy to discover that 
installing Drupal itself is—for the most 
part—surprisingly straightforward. A well- 
written web-based interface leads you 
through most of the process, and you’re 
usually given hints to solve any problems 
that arise. 

The only pieces of information you need in 
hand are: 

■ Your database name and password 

■ An email address to be associated with 
the site’s first user 

To install Drupal: 

1. If you’re installing on a local computer, 
make sure your AMP stack is running, 
with the Apache setting pointing at your 
Drupal folder. 

2. Go to the site in a web browser: 

► If you’re working on a local computer, 
the address is http://localhost. 

(If you’re using MAMP and left the 
ports in their default configuration, 
however, the address is http:// 
localhost :8888.) 

► If you’re working on a remote 
computer, point your browser at the 
domain where you’ve installed Drupal 
(for example, www. example. com). 

continues on next page 
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3. On the resulting page, you have a 
choice of whether to install Drupal 
“with commonly used features pre¬ 
configured,” or in a stripped-down 
(minimal) version ©. In fact, both install 
exactly the same software, but with 
different options enabled. Unless you 
have a particular reason to install the 
minimal version, I recommend that you 
go with the default, feature-filled ver¬ 
sion. Click “Save and continue.” 

4. The next page gives you the opportu¬ 
nity to install a version of Drupal with 
its interface in a language other than 
English, and instructions on howto 
do so. (The process involves finding, 
downloading, and installing a transla¬ 
tion package.) We’ll assume English is 
your preferred language; click “Save 
and continue.” 

5. If there are any problems with your 
installation, you’ll see a screen labeled 
“Requirements problem,” detailing the 
issue along with the status of several 
systems on which Drupal relies. (In ©, 
you see the error message you’d get 
if a necessary file had been deleted.) 
You might also see non-critical warn¬ 
ings, for example if your PHP memory 
limit was set so low that problems 
would probably happen eventually. 
After correcting the errors, click the 
“proceed with the installation” link at 
the bottom of the page. 


Select an installation profile 

& 

S« and co'iIihm 

© Selecting either the full-featured or minimal 
Drupal installation 

Requirements problem 
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© Notification of problems during installation 



© Configuring Drupal to use the database you 
created earlier 
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Completed 12 of 28. 4*» 

insulted Comment module. 


O Drupal’s installation progress bar 



© Drupal’s initial configuration screen, where you 
name your site and create the initial administrative 
user 


6 . When there are no other show-stopping 
problems, you’ll see the database con¬ 
figuration page ©. Enter the required 
information. If you didn’t change the 
database username or password as 
was described in “To install MAMP on a 
Mac” or “To install WAMP on a Windows 
computer,” the database username is 
root in both MAMP and WAMP; the 
default database password is root 

on MAMP, and WAMP has no default 
password. 

7. You’ll generally only need to change the 
advanced options in unusual situations. 
Talk to your Internet service provider if 
you can’t get past this step. 

8 . When finished, click “Save and 
continue.” 

A progress bar appears ©, typically just 
for a few seconds. 

9. If all goes well, you’ll see the “Config¬ 
ure site” screen ©. Your Drupal site 
is now installed, but if you don’t fill 
out the necessary fields in this form, 
you’ll be locked out and unable to 
administer it. (Should you accidentally 
close this screen, you can return to it 
by going to domain-name/ install. 
php?profile=standard&locale=en in 
a web browser.) 

continues on next page 
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10. Fill out the “Configure site” form. The 
user you create here is your Drupal 
site’s superuser, able to perform 

all administrative tasks; the email 
address you enter is where impor¬ 
tant site information will be sent. 

Make sure it’s correct! You’ll later be 
able to change all this information 
through Drupal if you want by going 
to http: !/domain-name laser 11 and 
http: //domain-name/ admin/config/ 
system/site-information. 

11. Click “Save and continue” for a confir¬ 
mation that all went well Q. Click the 
“Visit your new site” link to start admin¬ 
istering it©. You’re now logged in to 
your new Drupal site as the superuser. 
Congratulations! 


GD Drupal 7 introduced a new visual theme 
(called Seven) that appears when you perform 
administrative tasks. That’s what you saw 
when installing Drupal; 0 is the theme that 
visitors to your site see, and that appears 
when you’re doing non-administrative tasks. 
You’ll learn how to change these themes in 
the section “Selecting a Visual Theme” in 
Chapter 2. 



O Drupal, installed and ready to go 



0 Your new site’s home page as it appears when 
logged in as the superuser 


What Is This "localhost" I Keep 
Reading About? 

You might have noticed that the term 
localhost keeps popping up. That’s 
Apache’s way of saying, “The domain 
of the machine you’re currently using.” 
So entering http: //localhost into a 
browser looks for a site that’s running 
on the same computer as your browser, 
whereas www.example.com will go out 
onto the Internet to find example. com. 
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Establishing Your 
Drupal Site 


Now that you’ve installed Drupal, you may 
find yourself asking, “What now?” We’re 
going to take it step by step, starting with 
the tasks you probably want to do right 
away, and coming back to other adminis¬ 
tration tasks as we go through the book. 
But first you’ll learn how to: 

■ Use Drupal’s administrative interface 

■ Turn on features 

■ Create pages 

■ Change your site’s basic information 

■ Change the overall look of your site 
through built-in and downloaded 
themes 

■ Back up and restore your site 

■ Get help from the Drupal community or 
from Drupal’s built-in help 


In This Chapter 

Using the New Administrative interfaces 


in Drupal 7 22 

Turning on Built-In Features 28 

Giving Your Site Its Identity 29 

Selecting a Visual Theme 33 

Monitoring Your Drupal Site 40 

Packaging Your Drupal Site 43 




Using the New 
Administrative 
Interfaces in Drupal 7 

Version 7 of Drupal introduced several 
features to ease administrators’jobs. 

The first is two new themes. One is called 
Seven, which appears whenever you see 
a page for administering Drupal and favors 
clarity over flash ©. (You saw Seven during 
the installation process.) On other pages, 
Bartik is the new default theme ©. 

The second feature is an administrative 
overlay that appears in front of the page 
you’re affecting and helps administrators 
differentiate between pages that the public 
sees and those that only administrators 
see. This pretty effect appears whenever 
you follow a click path to an administrative 
page: for example, by clicking Modules. It’s 
possible to bypass the overlay by typing an 
administrative URL directly in to your web 
browser’s address bar or by disabling the 
Overlay module. 

Also new in Drupal 7 are a Toolbar and 
Shortcut bar. They float at the top of your 
browser window whenever you’re logged 
in as a user who’s been granted permis¬ 
sion to see them. (Those permissions are 
in the Shortcut and Toolbar groups on the 
Permissions page: To learn how to set 
them, see the section “To change user 
access permissions” in Chapter 7, “Wran¬ 
gling Users.”) 



© Seven, Drupal 7’s default administration theme 



© Bartik, Drupal 7’s default general-purpose 
theme 
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O The setting for changing the administration 
theme 


Throughout this book are directions to go 
to certain locations by clicking something 
in the Toolbar. However, you can also go to 
those places by typing the destination URL 
directly in your web browser’s address bar. 

Drupal now provides a dashboard you 
can customize to give you fast access to 
common tasks (such as monitoring recent 
comments). 

To change the administration theme: 

1. Click Appearance in the Toolbar. You’ll 
see the Appearance administration 
page Q. 

2. Scroll to the “Administration theme” 
section at the bottom of the page ©. 

3. Select the theme you want for the 
administration theme from the pop-up 
menu. If you want it to be the same as 
the theme on all other pages, choose 
“Default theme.” You also have the 
option of showing this theme whenever 
you edit or create content. Click “Save 
configuration.” 


GD The benefits of having a separate admin¬ 
istration theme become obvious if your main 
theme has a narrow content area or a lot of 
unusual customizations, which could make 
some administrative controls unavailable. 
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To see pages with the 
administrative overlay: 

1. Go to any administrative page, for 
example by clicking Modules in the 
Toolbar ©. 

2. To remove the administrative overlay 
and return to the page underneath it, 
click the x in its upper-right corner Q. 

GD When you see the administrative overlay, 
the page underneath it is coded into the URL 
showing in your browser’s address bar. Let’s 
say, for example, that you’re on the page 
http://domai/i-name/article-about-bears 
and click the Modules link in the Toolbar. The 
resulting URL is http: // domain-name/ 
article-about-bears#overlay=admin/ 
modules. 

To see pages without the 
administrative overlay: 

Reach an administrative page by typing its 
URL directly in your browser’s address bar, 
for example http: //localhost/admin/ 
modules © 



© The Modules page with the administrative 
overlay 



© Removing the administrative overlay 



© The Modules page, as seen when you type its 
URL in your web browser’s address bar 
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© The check box on the Modules page where 
you can disable the administrative overlay 


To turn off the administrative 
overlay entirely: 

1. Click Modules in the Toolbar. 

2. Scroll down to deselect the Overlay 
check box © 

3. Scroll to the bottom of the page and 
click “Save configuration.” The admin¬ 
istrative overlay will remain off until you 
enable it again. 


UU You can switch between seeing and not 
seeing the administrative overlay by remov¬ 
ing the path to the underlying page and the 
#overlay= in the URL. So for the Modules 
pages shown in and (3 , the URLs are 
http:/ /domain-name/axticle-about 
-bears#overlay=admin/modules and 
http: //localhost/admin/modules respec¬ 
tively. Conversely, you can see the administra¬ 
tive overlay by adding that text. The content is 
the same in both cases. 
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To change which items appear 
in the Shortcut bar: 

There are two ways to add items to the 

Shortcut bar. Either: 

■ Navigate to the administrative page for 
which you’d like a shortcut in the Short¬ 
cut bar, then click the + sign icon next to 
the page’s name O- The shortcut’s text 
will be the same as the page’s name—in 
this case, “Content types.” 

or 

■ Click “Edit shortcuts” in the right side 
of the Shortcut bar itself to show the 
“Edit shortcuts” page O- Then click 
“Add shortcut,” type the name and 
path of the shortcut you’d like to add 
(without the http ://domain-name/ or 
underlying-page-URL#ove rlay=admin 
parts), and click Save Q 


GD When you link to administrative pages 
in the Shortcut bar, those links will always 
show the resulting pages with the administra¬ 
tive overlay, as long as the Overlay module is 
enabled. 

GD You can set up multiple Shortcut bars, 
each with its own set of shortcuts, by clicking 
Configuration > Shortcuts. 


Content types 0 Add to Default shortcuts 


Home » Administration » Structure 


O Adding a link to the Shortcut Bar from (nearly) 
any page in Drupal 



O The administration page for adding links to the 
Default Shortcut bar 


Add new shortcut * 





o Adding a link to the Shortcut bar by typing in 
the target page’s URL 
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O The Dashboard 



(D The Dashboard, ready to customize 



o Adding an item to the Dashboard 



© The newly changed section of the Dashboard 


To customize the Dashboard: 

1. Display the Dashboard by clicking 
Dashboard in the Toolbar O' 

2. Click the “Customize dashboard” link. 
Dotted lines appear around areas 
where you can place Dashboard items 
that are shown in a gray area near the 
top of the screen ©. 

3. Drag any of the Dashboard items into 
the areas delimited by dotted lines © 
To remove a Dashboard item, drag it 
back into the shaded gray area. 

4. When you’ve arranged all the Dash¬ 
board items you want in the desired 
areas, click Done. The Dashboard now 
appears with the items in place and 
ready for use ©. 

GD Dashboard Items are actuallyjust blocks. 
For more about blocks, see “Laying Out Your 
Site with Blocks” in Chapter 6, “Improving 
Access to Content.” 

GD Many of the Dashboard items are 
dynamic: That is, they change depending on 
what’s on your site. (The tVho’s online item is 
a good example.) 
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Turning on Built-In 
Features 

Drupal comes well-configured fresh out of 
the box: You don’t have to change it much 
to create a simple but effective site. In fact, 
you’ve already learned all you really need! 

But for simplicity’s sake, some features of 
Drupal are disabled by default. 

This section tells you how to turn on those 
built-in features, called modules. 

To turn on built-in features: 

1. Go to the Modules page by clicking 
Modules in the Toolbar ©. 

Modules are self-contained pack¬ 
ages of software that give Drupal 
its functionality. Some are required 
by Drupal. Others are optional; by 
default, Drupal comes with some of 


these optional modules enabled. 

There are also hundreds of additional 
modules available for free download 
at drupal.org/project/modules. 

For more information about them, see 
Chapter 9, “Extending Drupal with 
Modules.” 

2. Select the check box next to the feature 
you want to enable. 

3. Scroll to the bottom of the page and 
click “Save configuration.” 

4. Most modules come with one or more 
administration pages that appear after 
you enable the module. The quickest 
way to find them is to click the Config¬ 
ure link on the Modules page next to 
the new module. 

GD Another place to find documentation for 
downloaded modules is among the modules’ 
files themselves, particularly those named 
README.TXT and INSTALL.TXT. 
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© The Modules administration page 
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© Choosing whether to create an article or a 
basic page 


Giving Your Site 
Its Identity 

Your newly installed Drupal site is like a 
newborn baby: full of possibilities and 
just waiting for shaping influences. Its 
design, like human DNA, determines what 
it can be, in a huge range from a simple 
“brochure” site to a complex customer- 
relations management system. As with a 
baby, the actions you take from the begin¬ 
ning of your site’s “life” can have profound 
effects on its direction. 

But your new Drupal site is unlike a baby in 
many ways, and two are of particular inter¬ 
est. First, your Drupal site won’t naturally 
grow without your involvement. Second, 
your actions are usually reversible— 
although you might have to untangle a 
series of steps to correct earlier errors. 

This section shows you how to give your 
site its own personality right from the 
beginning. For some of you, this is all you’ll 
need: By the end of this section, you’ll 
have a functioning (albeit simple) multipage 
site that contains your name and some 
content. 


To create your site's 
home (front) page: 

1. Go to the Add content page by clicking 
“Add content” in the Shortcut bar. 

2. Click the “Basic page” link ©. 

The section “Gaining More Control of 
Individual Nodes” in Chapter 3, “Creat¬ 
ing and Managing Content,” discusses 
differences between the article and 
basic page content types. 

continues on next page 
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Create Basic page • 


3. Enter title and body content into the 
Title and Body fields ©. Here you can 
also add a summary by clicking the 
“Edit summary” link. The summary is 
used to describe content, and appears 
in various places where a brief descrip¬ 
tion is more useful than the full body. 
(For more about summaries, see “Gain¬ 
ing More Control of Individual Nodes” in 
Chapter 3.) 

4. Scroll down on the form and click “Pub¬ 
lishing options.” Although it looks some¬ 
what like a link to another page, it’s 
actually a control called a tab: Clicking it 
reveals a new group of settings without 
taking you away from the current page. 

5. Select the “Promoted to front page” 
check box ©. 

6 . Click Save at the bottom of the form to 
see the completed page ©. Near the 
page’s title are two tabs: View (which 
is selected) and Edit. You can edit 

the page at any time by clicking the 
Edit tab. 

7. To confirm that the content you just 
entered is on the front page, you can: 

► Click the site’s logo. 

► Click the site’s title (“My Drupal Site” 
in this case). 

► Click the little “Home” icon in the 
Toolbar. 

► Type http ://domain-name in your 
web browser. 

Doing so returns you to the front page 
to see a screen similar to 0 but without 
the View and Edit tabs. (If you entered 
a summary, you’d see it here instead of 
the contents of the Body field.) To edit 
the content again, click its title, then 
click the Edit tab. 




O Creating a page’s content 



© Making the page’s content part of your site’s 
front page 



©The published page 
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How Can a Page Contain a Page? 
And What's a Node? 

The word page has two different mean¬ 
ings in Drupal. In one sense it means 
anything within boundaries of your 
browser’s window. But in the other, 
it means a node of the basic page 
content type. 

When you clicked “Create content” to 
make that first front page, Drupal pre¬ 
sented you with the choice of creating 
a basic page or an article. These are 
the two content types that are available 
in Drupal by default. Another example 
of a content type is blog entry, which 
becomes available when you turn on the 
Blog module. (You’ll see how to do that in 
Chapter 3.) Other content types appear 
when you download and install other 
modules, or when you specifically create 
them. 

Whichever content type you choose— 
basic page, article, or something else— 
the resulting unit of content is stored as 
a node in Drupal. Its contents appear on 
its standalone page at http :/ /domain 
-name /node/ node-identifier. (In our 
example, that was http: //localhost/ 
node/1.) A node typically appears in the 
content region (generally in the middle 
of the page), surrounded by other page 
parts such as the header and footer. 

The node can appear elsewhere in 
the site, though, sometimes grouped 
together with other nodes. That’s the 
case on the front page, where you’ll 
see all nodes that have the “Promoted 
to front page” setting selected. In such 
cases, you can always return to that 
node’s standalone page to view and edit 
it by clicking its title or entering its URL in 
your web browser. 


To change your site's 
basic information: 

1. Go to the site information page by click¬ 
ing Configuration > Site Information in 
the Toolbar. 

2. You see a page that looks similar to one 
that appeared during the installation 
process. Here you can: 

► Change the site’s name. The name 
appears most prominently at the top 
of every page, but also in such places 
as administrative emails and in the 
Title Bar of many browsers. 

► Change the site’s slogan. The slogan 
appears in some themes below the 
site’s name at the top of the page and 
in the Title Bar of the browser when 
looking at the home page. You’ll learn 
more about the site slogan in the sec¬ 
tion “Selecting a Visual Theme” later 
in this chapter. 

► Change the administration email 
address. Emails sent automatically by 
Drupal will appear to come from this 
address. By default it’s the same as 
the one for the administrative super- 
user— that is, the user created when 
you first installed Drupal. 

► Change the number of posts that 
appear on the front page. This num¬ 
ber determines how many “Promoted 
to front page” nodes show on the 
front page at one time. When there 
are more than that number, links 

at the bottom of the page (known 
as a pager) will let visitors see 
older nodes. 

continues on next page 
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► Redirect visitors to alternative target 

pages. You can do this: 

• For the front page (“Default front 
page”) 

• When they’re denied access to con¬ 
tent (“Default 403 (access denied) 
page”) 

• When they try to go to a page that 
doesn’t exist (“Default 404 (not 
found) page”) 

These pages can be anywhere on your 
site as long as they have valid URLs, 
including nodes (such as node/l) or a 
system page (such as user). 

3. When you’ve finished making your 
changes, click “Save configuration.” In 
our example, we’ve changed the site’s 
name to “Sunrader Fans” and added 
a slogan Q. 



$j| The “Site information” page 
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Selecting a 
Visual Theme 

Traditionally, a web site’s creator tackles 
visual design very early in the process. 
Often the design comes even before the 
content, which then has to be developed 
to fit its constraints. 

But as a content management system, 
Drupal puts more importance on content— 
that is, the information that you put in 
nodes. A theme tells Drupal how to display 
that content. You can change themes, even 
when your site has thousands of nodes, and 
your site will still (mostly) work as expected. 

A Drupal theme typically includes five parts: 

■ Style files define such matters as typog¬ 
raphy and layout. They are CSS (Cas¬ 
cading Style Sheets) and end in .css. 

■ Programming files give the theme logic 
so that, for example, a catalog page 
looks different from a user’s profile. 

They are written in PHP and end in .php. 

■ Graphics files typically appear as pat¬ 
terned backgrounds, icons, and splash 
images. They can be in any format 
understood by web browsers, most 
commonly with filenames ending in 
.jpg, .gif, and .png. 

■ A metadata text file ending in .info 
contains the information that Drupal 
uses to keep track of such matters as 
theme name, version, description, and 
referenced files. 

■ Script files containing code to enhance 
the features of a theme in a dynamic 
way. These JavaScript files end in .js. 

Of these five parts, only the .info file is 
really required to create a new theme. The 
rest are added as needed. 

continues on next page 
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Core Drupal includes four themes in the 
themes folder. Many additional free and for- 
purchase themes are available for down¬ 
load from drupal.org/project/themes 
and elsewhere, and anyone with ambition 
and some CSS knowledge can design a 
theme from scratch. 

This section discusses only the basics of 
enabling, selecting, and installing themes. 
Chapter 8, “Customizing Drupal’s Look and 
Feel,” provides further details. 



Q The theme selection page 


To use a built-in core theme: 

1. Go to the Appearance administration 
page by clicking Appearance in the 
Toolbar. You will see a list of available 
themes ©. 

2 . Click the “Set default” link next to the 
theme you want to use. 

A section at the bottom of this page 
lists disabled themes, which are in 
your Drupal folder but unavailable for 
any purpose until you enable them. To 
enable a theme, click the Enable link 
next to it. To enable a disabled theme 
and make it the active theme, click its 
“Enable and set default” link. 

3 . Click “Save configuration.” To see the 
new theme, go to a content page. 


GD Changing the theme in this manner only 
affects content pages, not administrative 
pages. For that, see the section “To change 
the administration theme” earlier in this 
chapter. 
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Appearance ■ 



© Changing settings for the Garland theme 



© Color settings for the Bartik theme, with the 
Blue Lagoon color set selected 


To change a theme's settings: 

1. Go to the Appearance page by clicking 
Appearance in the Toolbar. 

2 . Click the Settings link to the right of the 
theme you want to change © to go to 
that theme’s settings page, or click the 
Settings tab in the upper-right corner 
of the screen, then click the name 

of your theme below that tab in the 
resulting page. 

3 . Available settings vary from theme to 
theme. One nice feature of Bartik is that 
it’s recolorable —that is, you can choose 
colors for several interface elements. 
(Few themes have this feature.) 

► To select a group of colors designed 
to look harmonious together, choose 
an option from the “Color set” 
pop-up menu. 

► To change the color of an individual 
interface element, click its field then 
either type the hexadecimal value of 
the color or click the desired color in 
the color wheel. 

The preview immediately changes to 
reflect your choices ©. 

continues on next page 
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4 . The “Toggle display” section further 

down on the screen © lets you show or 

hide various theme features: 

► The logo is the picture that usually 
appears in the screen’s upper-left 
corner. This check box turns its 
display on or off: See the logo image 
settings in step 5 to learn how to 
change the logo. 

► The site name and site slogan are set 
on the “Site information” screen. See 
the earlier section “To change your 
site’s basic information” for details. 

► The “User pictures in posts” and 
“User pictures in comments” check 
boxes are unavailable until you’ve 
turned on the “Enable user pictures” 
setting on the “Account settings” 
page at http :// domain-name/ 
admin/config/people/accounts. 

For more details, see Chapter 7. 

► The “User verification status in com¬ 
ments” check box comes into play 
when you allow anonymous users— 
that is, those who haven’t logged 
into Drupal—to leave comments in 
response to node content. (Learn 
how to allow that in the section “To 
change user access permissions” 

in Chapter 7.) If you leave this box 
selected, comments left by users 
who include their name and contact 
information will be accompanied by 
the text “not verified.” 

► The “Main menu” and “Secondary 
menu” check boxes define whether 
the two menus appear. In Bartik and 
most other themes, they’re in the 
upper-right corner. 


TOGGLE DISPLAY 

Enable or disable the display of certain page elements. 
M Logo 

is/ site name 

I*/ Site slogan 

is/ User pictures in posts 

Is/ User pictures in comments 

is/ User verification status in comments 

0 Shortcut icon 

£3 Main menu 

iVi secondary menu 

© The “Toggle display” section of the theme 
settings screen 
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© Accepting the default shortcut icon on the 
theme settings screen while uploading a custom 
logo 


What's All This about Global 
Settings? 

If you clicked the Settings tab on the 
Appearance screen, you might have 
noticed the enigmatic phrase “Global 
settings.” Clicking it brings you to a set¬ 
tings screen very similar to the one you 
were editing. So what’s the difference? 

The global settings screen is a place to 
set theme defaults', that is, what you see 
when you first visit the settings screen 
for a specific theme. You can ignore it 
if you plan to use only one theme on 
your site. But it comes into play if you 
plan to experiment with several differ¬ 
ent themes. Having intelligent defaults 
in place prevents you from having 
to re-create the same settings time 
after time. 


5 . The “Logo image settings” and “Short¬ 
cut icon settings” sections define what 
images these items use. By default, 
Drupal uses whatever image was 
included with the theme, but you can 
change it by deselecting the relevant 
check box ©. 

There are two ways to indicate an 
image file: 

► Upload the file manually to some¬ 
where on the Internet. A typical place 
is inside your site’s theme folder, 
such as at /sites/default/themes/ 
theme-name or /sites/all/themes/ 
theme-name. (Don’t ever add or 
change files to the /themes folder; 
you’ll lose such changes when you 
eventually update Drupal.) Then, tell 
Drupal where to find it by typing its 
path in the “Path to custom logo” 

or “Path to custom icon” field (for 
example, sites/default/themes/ 
theme -name / new - logo. j pg). 

or 

► Upload it by clicking the appropriate 
Browse button and selecting your 
image. 

6 . When you’ve made all your desired 
changes, click “Save configuration.” 
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To find, download, install, and 
enable an alternative theme: 

1. Go to a site where downloadable 
themes are available. By far the most 
common source for free themes is 
drupal.org/project/themes. Theme 
Garden (themegarden.org) links to 
many of the themes found on the 
drupal. org site and lets you try them 
out before downloading them. A web 
search for “drupal themes” turns up 
several other free theme sources, along 
with suppliers of commercial themes. 

2 . Select a theme. Either: 

► Download the theme to your 
computer. 

or 

► Copy the URL where the theme is 
located. To do so, press the Control 
key while clicking the download link 
(on Mac) or right-click the download 
link (on a computer with a two-button 
mouse). Then select “Copy link 
location.” 

3 . On your site, go to the Appearance 
page by clicking Appearance in the 
Toolbar. 

4 . Click the “Install new theme” link, which 
leads you to a screen where you can 
either paste the URL you copied earlier, 
or click Browse and upload the theme 
you downloaded Q. 

5 . Click Install. Your theme is now installed 
and appears on the Appearance page. 



Q The theme installation screen 
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0 Enabling the newly installed Zen theme and 
setting it as the default 


6 . To set your theme as the one seen 
by visitors to your site, return to the 
Appearance page by clicking Appear¬ 
ance in the Toolbar. Then click Enable 
to simply make the theme available, or 
click “Enable and set default” to make it 
both available and the active theme 0 

QQ Make sure you’ve downloaded a theme 
designed for the Drupal version you’re using. 
Drupal 6 (and earlier) themes won’t work on a 
Drupal 7 installation. 

GD Instead of using Drupal’s “Install new 
theme” link, you can also install the theme 
by downloading it, uncompressing it, and 
placing the resulting package in the /sites/ 
default/themes,/sites/all/themes,or 
site-specific folder of your Drupal installation. 
(That’s how theme installation worked in the 
previous versions of Drupal.) 


Understanding the sites Folder 

The sites folder in your Drupal installation is intended to contain all the files that are specific to 
your site. (When you install a new theme, for example, Drupal puts it in /sites/all/themes.) That 
structure makes updating Drupal easy: When a new version comes out (as happens every month 
or so), the only directory you need to move to the new installation is the sites folder. For more 
details on updating, see the “To update Drupal” section later in this chapter. 

One installation of Drupal can run multiple sites. (We won’t discuss such multisite installations in 
this book; for tutorials on the subject, see drupal.org/node/438l6.) The sites folder reflects 
that by containing two folders, named all and default. To run a multisite installation, you’d basi¬ 
cally add other folders, each one indicating a different site and containing different files. 

Modules and themes put in the all folder are available to all sites in a multisite installation; those 
in another folder are available only to the site associated with that folder. 

When you install modules and themes using Drupal’s own installation process, they automatically 
go into the all folder. But you could manually put files into other folders within the sites folder 
by downloading, uncompressing, and moving them there. You’d first need to create folders named 
modules or themes in those folders, however. 

In any case, one thing bears repeating: Never add or change files outside of the sites folder, 
because you’ll lose them when you update Drupal. That way lies madness. 
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Monitoring Your 
Drupal Site 

Like a living thing, your Drupal site requires 
attention to stay in tip-top health. Develop¬ 
ers correct newly discovered code flaws; 
resources your site relies on move or dis¬ 
appear; hardware fails; and online vandals, 
as always, try ever more devious ways to 
attack. Regular maintenance procedures 
ensure that you’re both protected from 
danger and able to recover when disaster 
strikes. 

Maintenance requires both attention and 
action. Fortunately, Drupal includes reports 
that make monitoring easy; unfortunately, 
some maintenance actions are a bit tricky. 
But done periodically, they’re an effec¬ 
tive defense against the thousand natural 
shocks that Drupal is heir to. 


To correct most routine 
Drupal system issues: 

1. To see a list of items that Drupal 
automatically checks, click Reports 
in the Toolbar and then click “Status 
report” ©. The list on this page may 
grow as you enable more modules. 

2 . Examine the page for errors—that is, 
any items highlighted with a contrasting 
background color. 

Those with a non-critical issue display 
with a blue background; those that are 
likely to cause problems display with a 
red background. 

In any case, links in the descriptive text 
lead you to a page on your Drupal site 
where you can correct the error or to a 
help resource that will guide you to its 
resolution. 



© Drupal’s “Status report” screen 
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© Database logging options 



© Recent log messages 



© Clearing the database log 


To track system activity 
on your Drupal site: 

1. By default, Drupal’s database logging 
(dblog) system keeps track of various 
activities on your Drupal site, such as 
user logins, content additions, page- 
access problems, and PHP errors. 

You can reduce the amount of tracking 
activity and change the number of log 
entries that Drupal saves by clicking 
Configuration in the Toolbar and then 
clicking “Logging and errors” ©. 

After you’ve made your changes, click 
“Save configuration.” 

2 . You can see a complete list of log 
entries by clicking Reports in the 
Toolbar and then clicking “Recent log 
messages.” Entries appear from newest 
to oldest ©. 

3 . Removing all messages from the data¬ 
base log and starting with a clean slate 
is sometimes useful—for example, if 
you want to track errors over a specific 
period of time, or to debug a problem 
without getting noise from previous 
attempts to solve it. To clear the log, 
first click the “Clear log messages” link 
or its disclosure triangle ©. Then click 
the newly revealed “Clear log mes¬ 
sages” button. 

continues on next page 
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4 . You can hide database log messages 
you don’t want to see, thereby focusing 
on, for example, emergency-level sys¬ 
tem messages. To do so, click the “Filter 
log messages” link, or its disclosure 
triangle, to reveal the filter controls. 

Then select both the types and the 
severity levels of messages you want © Narrowing the list of database log messages to 

to see. To select multiple items, press show only certain ty pes and severity levels 

the Command key (Mac) or Control key 
(Windows) while clicking. When you’ve 
made your selections, click the Filter 
button ©. 

5 . Drupal also offers two summary pages 
to quickly check common access 
problems: 

► To see a list of pages that visitors 
have tried to access without permis¬ 
sion, click Reports in the Toolbar 
and then click “Top ‘access denied’ 
errors” Q. 

► To see a list of nonexistent pages 
that visitors have tried to access, click 
Reports in the Toolbar and then click 
“Top ‘page not found’ errors.” 




Q The access denied page, with pages that have the most failed attempts 
topping the list 
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Packaging Your 
Drupal Site 

So—you’ve created the perfect Drupal site 
on your laptop. It’s time to go live! 

Moving your Drupal site to a server takes 
two steps: 

■ Move the files. 

■ Move the database. 

Learning how to move your site also 
teaches you another valuable skill: how to 
back up and restore your site in case of 
emergency. In either case, the procedures 
aren’t difficult. However, the cost for failure 
is high. 

A backup that you can’t use is as bad as 
no backup at all. Therefore, try restoring 
your site from backup once in a while— 
preferably on a test site, not your live 
site—to make sure that everything works 
properly. It’s better to discover something 
amiss when you’re calm and unhurried 
than when your site is down and users are 
clamoring for its return. 

Finally, this section also includes informa¬ 
tion about updating Drupal—a process 
you’ll find yourself doing about once a 
month. It’s a bit of a pain, but your site get¬ 
ting cracked because you didn’t install the 
latest security patch is far worse. 


Establishing Your Drupal Site 43 




To back up your Drupal 
installation's files: 

1. Backing up your Drupal site is a two- 
step process. The first step is to put a 
copy of your Drupal files in a safe and 
accessible place: 

► On Mac or Windows: Click once on 
the folder containing your Drupal files, 
then press Command-C (Control-C) 

to make the copy. Navigate to where 
you want to save the copy, then press 
Command-V (Control-V) to paste it in 
its new location. 

► On *nix: Use the command tar -cvzf 
target-file source-directory 

to create a compressed, single-file 
tarboll archive of your site. (For help 
using *nix commands, see the “To 
transfer Drupal to a *nix server” sec¬ 
tion in Chapter 1, “Getting Drupal Up 
and Running.”) 

► If your files are on a remote server 
and you want to store them on a 
local computer: First create a tarball, 
as described in the preceding step; 
then use an FTP or SCP program to 
transfer the file between the two. 


2. Optional: Compress the backup you 
just created to save space: 

► On Mac: Press the Control key while 
clicking the folder, then choose 
“Compress foldernome ” from the 
pop-up menu. 

► On Windows: Select the file, right- 
click, and from the contextual menu 
choose Send To > Compressed 
(zipped) folder. 

► On *nix: The files were compressed 

in step 1 when you created the tarball. 

3. Label and store the backup. 

Too many people forget this step and 
end up with a bunch of mysterious files 
labeled backup in random folders. I use 
the pattern YYYYMMDD-site name. For 
example, a copy of the site drupalvqs 
saved on December 10, 2010 would 
have the name 20101210-drupalvqs. 

A nice side effect of this convention 
is that files appear sorted chronologi¬ 
cally, so it’s easy to find the most recent 
backup. 

GD In reality, you don’t need to back up your 
entire Drupal installation. You could make 
do with just the sites folder, which includes 
all the files, modules, and themes that are 
specific to your site. However, I still prefer to 
make a full backup once in a while. Doing so 
removes the possibility of incompatibilities 
between my old modules and the newly 
downloaded version of Drupal. Such incompat¬ 
ibilities are rare, but it’s better to be safe than 
sorry when disk space is so cheap! 
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© The phpMyAdmin Export screen 


r- Export- 

Select All / Unselect All 


drupalvqsdb 


information_scfiema 

mysql 

test 


O Selecting the 
database to export 


(A Save m flte- 

Fite name template 1 : _SFRVER_ ( remember template) 

Compression: Q None 0 •zipped" 0 '9*>PP®d" 0 "topped* 

_ ^ 


© Exporting your Drupal site’s database to a file 
in . zip format 


To back up your Drupal site's 
database using phpMyAdmin: 

1. Launch phpMyAdmin, as described 
in the “Creating the MySQL Data¬ 
base Using phpMyAdmin” section in 
Chapter 1. 

Your Internet hosting provider might 
require you to use some other proce¬ 
dure; contact its support department 
if so. 

2. Click the Export link to go to 
phpMyAdmin’s Export screen ©. 

3. Click the name of your database—in 
this example, drupalvqsdb ©. 

If you don’t see the name of your data¬ 
base, you probably don’t have export 
permissions; ask your system adminis¬ 
trator for this permission. 

4. Select the “Save as file” check box 
at the bottom of the screen. You can 
optionally name the file and choose to 
download the file in compressed format 
(doing this saves time). Then click the 
Go button 0. 

If you later have difficulty importing your 
database, you might need to change 
one of the other settings on this page. 
They’re too numerous to detail here: 
Talk with your system administrator for 
recommendations. 

The database will download to your 
web browser’s default download 
location. 
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To restore your Drupal 
site from backup: 

1. Find the most recent backup of your 
Drupal installation files. If the files are in 
a compressed package, uncompress it. 

2. Delete your old Drupal installation files, 
if necessary. 

3. Move the uncompressed backup folder 
to the former location of your old Drupal 
installation. Be sure to move the entire 
folder, not just its contents. It contains a 
hidden file (.htaccess) that you’ll miss 
by just copying the visible files. 

4. You now need to drop (delete) 
your site’s old database. Launch 
phpMyAdmin, as described in the previ¬ 
ous section, “To back up your Drupal 
site’s database using phpMyAdmin.” 

5. Click the Databases link in phpMyAdmin 
to see a list of available databases. 

6 . Select the check box next to your data¬ 
base ©. 

7. Scroll to the bottom of the screen and 
click the icon with a red X through it 
to the right of the text “With selected.” 
You’ll see a warning that asks you 
whether you really want to destroy your 
database. Click Yes. 

8 . Now it’s time to import the backup data¬ 
base. In phpMyAdmin, click the Import 
tab at the top of the screen to see the 
Import screen ©. 

9. Click the Browse button, then find 
and select your backup database file 
through the file selection dialog box. 


|pi Databases 


Database * 

% 

drupalvqsdb 

si 


information_schema 

£ 


mysql 

CP 

□ 

test 

3 

Total: 4 


"t_ Check All / Uncheck All With selected: 3§" 


© Selecting a database to drop 
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$databases[ 1 defauIt']['defauIt'] = arnay( 

1 driver' => 'mysqt 1 , 

'database' => 'drupa l vqsdb', 

'username' => 'root', 

'password' => 'root', 

'host' => 'locaIhost', 

'prefix' => ’ ', 

); _ 

O The section of settings. php you may need to 
change when you move your Drupal site 


Help! I Couldn't Import My 
Database! 

Hoo-boy. As you might have guessed 
from the complexity of the database 
import/export screens, this is an area rich 
with potential problems. Some Internet 
hosting providers don’t allow you to 
create databases directly, for example; 
in that situation you’d have to modify the 
instructions a fair amount. 

One common error is that phpMyAdmin 
on a Windows computer won’t let you 
import databases larger than 2 MB. To 
fix that, see the section “To configure 
WAMP for Drupal on a Windows com¬ 
puter” in Chapter 1. Another solution is 
to use the program BigDump, available 
from http://ozerov.de/bigdump.php. 

You can find further database help at 

http://drupal.org/node/8l995. 


10. Click Go. 

There will be a pause while 
phpMyAdmin imports the file. You won’t 
see any changes until it’s finished, but 
don’t worry if it takes a few minutes. 
When finished, you’ll see a message 
that “Import has been successfully 
finished.” 

11. Your site is now restored: To be sure, go 
to it in a web browser. You’ll probably 
find that you’ve been logged out. Log in 
again if necessary. 

itil These instructions assume that you 
don’t need to back up your current installation 
before restoring from backup. If you do, follow 
the backup procedure first before deleting 
your current files and database. 

To move your Drupal site 
to another computer: 

1. Back up your site’s files and database. 

2. Restore the site in its new location by 
copying those files and importing that 
database. 

3. In the Drupal installation that’s in its 
new location, open the file at /sites/ 
default/settings. php with a text 
editor. 

4. Find the section that begins with 
(databases = array, which is at or 
around line 181 Q. 

5. Change the information as needed for 
the new location. (Often the database 
user name or password will be different 
for your remote database server.) 


GD You might have noticed that this file 
actually contains your database’s user name 
and password in plain text. Don’t leave it in 
an accessible place! 
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To update Drupal: 

1. Go to the updates page by clicking 
Reports in the Toolbar and then clicking 
“Available updates.” 

On the resulting page, warning icons 
tell you whether you should update 
modules, themes, or Drupal itself. (In 
this chapter we’ll only discuss how to 
update Drupal itself. To learn how to 
update individual modules or themes, 
see Chapter 9.) 

2. Each update includes a description with 
several links, most of them informa¬ 
tional. To download the latest version, 
click the Download link or use the *nix 
wget command. 

(For help downloading the package, 
see the “To download Drupal to a Mac 
or Windows computer” and “To trans¬ 
fer Drupal to a *nix server” sections in 
Chapter 1.) 


3. For Mac or Windows: Double-click the 
downloaded package to uncompress 
it. On Windows, you’ll need to install a 
utility as was discussed in the Chapter 1 
sidebar “Help! I Can’t Uncompress the 
File!” 

For *nix: Type tar -xzvf 
drupal-package. 

4. Take the site offline by clicking 
Configuration in the Toolbar and then 
clicking “Maintenance mode” © 

Select the “Put site into maintenance 
mode” check box and click “Save 
configuration.” 

Visitors attempting to reach your site 
now see the offline message you 
indicated. 

5. Remove the sites folder from the 
newly uncompressed package. 


Maintenance mode <4 


Home » Administration » C on figuration ■ Development 


If you are upgrading to a newer version of Drupal or upgrading contributed modules or themes, you may need to run 
the update script. 

(91 Put site into maintenance mode 

* When enabled, only users with the ‘Use the site in maintenance mode* permission are able to access your site to 
perform maintenance: all other visitors see the maintenance mode message configured below. Authorized users 
can log in directly via the user login page. 


Maintenance mode mtiiagt _ 

&WW3flGf fans « currently under maintenance. Wo should bo baox shortly. Than* you tor your pononoo. 


Message to show visitors when the site is in maintenance mode 


Save configuration 



© Turning on your site’s Maintenance mode to keep visitors away while you’re 
working on it 
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6. Move or copy the sites folder from 
your old Drupal installation to the 
new one. 

7. Next you’ll remove your old installation 
and move the new installation (contain¬ 
ing a copy of your old sites folder) into 
its place. First, move the old installation 
to another location. Then, give your 
new Drupal installation the same name 
as the old one and move it to the loca¬ 
tion of the old one. 

The new installation now has the same 
name and location as the old one did, 
and it contains the old one’s sites 
folder. 

8 . Now it’s time to update the Drupal 
database to make it compatible with 
changes in the code files. Either: 


► Click the “update script” link on the 
Maintenance mode page. 

or 

► Go to the update page by typing 
http://doffi£?in-/iame/update.php in 

your browser’s address bar. 

In either case, you must be logged in 
as the user you created when you first 
installed Drupal (the superuser), or as a 
user that has been granted the “Admin¬ 
ister software updates” permission. To 
learn about permissions, see Chapter 7. 

9. A page describing the update process 
appears ©. Click Continue. 

10. When the process is complete—usually 
within a few seconds—you get a mes¬ 
sage about what changes were made, 
along with links back to view and 
administer your site. 

continues on next page 


Drupal database update 



V Verify requirements 

► Overview 


Use this utility to update your database whenever a new release of Drupal or a module 
it installed. 

Tor more detailed Information, see the upgrading handbook. If you are unsure what 
these terms mean you should probably contact your hosting provider. 

1. Back up your database. This process will change your database values and in 
case of emergency you may need to revert to a backup. 

2. Back up your code. Hint: when backing up module code, do not leave that backup 
in the 'modules' or 'aitcs/*/modulcs' directories as this may confuse Drupal's 
auto-discovery mechanism. 

3. Put your site into maintenance mode. 

4. Install your new files in the appropriate location, as described in the handbook. 
When you have performed the steps above, you may proceed. 

Continue 


© Starting the update process 
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11. Turn the site back on again by clicking 
Configuration in the Toolbar and then 
clicking “Maintenance mode.” Then 
deselect the “Put site in maintenance 
mode” check box and click “Save 
configuration.” 

Your Drupal installation is now up 
to date. 

GD There are actually a few different ways to 
update Drupal. The one shown here assumes 
that there’s a place on your computer outside 
your current Drupal installation where you can 
set up the new installation, and that you can 
move and delete files at will. If that’s not true 
for you—if, for example, you don’t have access 
to anyplace on the server other than the inside 
of your Drupal installation’s directory—then 
you’ll have to adapt these instructions to fit 
your situation. 

GD If you’ve been administering Drupal 
correctly, you’ll need to move only the sites 
folder; everything outside that folder is con¬ 
sidered the Drupal core and will be replaced 
by the new Drupal installation. If you’ve made 
any changes outside of that folder, they’ll be 
destroyed by the update. That’s why Drupal 
developers constantly warn: “Don’t hack 
core!” (“Core” is Drupal’s central program¬ 
ming, which comprises the entire Drupal 
installation outside the sites folder.) 

GD Whenever updating your site, log in as 
the administrator in a browser, such as Firefox. 
Then after step 4, when the site is offline, visit 
it in another browser, such as Safari, without 
logging in, so that you see the “currently 
under maintenance” message. That serves as 
a reminder to put the site back online when 
you’re finished; you wouldn’t believe how 
often Drupal administrators forget to do that! 
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Creating and 
Managing Content 


Now that you’ve installed and configured 
Drupal, you’re like someone who’s just 
walked out of a car dealership, keys in 
hand. You had to deal with some neces- 
sary-but-technical tasks, just as the new-car 
buyer had to deal with title and loan paper¬ 
work. Now it’s time to get in and drive! 

In this chapter, you’ll learn how to: 

■ Create nodes of various kinds 

■ Adjust how those nodes appear and 
behave 

■ Handle books, blog posts, and news 
feeds 

■ Manage content en masse 

Three other chapters help you further 
improve your site’s content. Chapter 4, 
“Customizing Content,” shows you how 
to work with images and create your own 
content types; Chapter 5, “Making Content 
Interactive,” shows you how to let users 
talk to each other (and you) within your 
site; and Chapter 6, “Improving Access 
to Content,” moves content beyond the 
boundaries of the nodes that contain it. 


In This Chapter 

Gaining More Control of Individual Nodes 52 
Creating Other Types of Content 61 

Finding, Editing, and Deleting Content 71 




Gaining More Control 
of Individual Nodes 

Drupal lets you create two types of content 
by default: articles and basic pages. You 
can also create your own content types, as 
you’ll learn in Chapter 4. All content types 
are available when you click the “Add new 
content” link. 

Both articles and basic pages contain the 
following elements: 

■ Title: This is the only required field in 
most edit forms. It becomes the click- 
able link that lets visitors view the full 
node. 

■ Summary: A short description of the 
node, which will later appear in places 
where the full node would be unwieldy 
or inappropriate. The Summary section 
is like a blurb on a newspaper’s front 
page: just long enough to get people 
interested in the story. If you leave the 
summary blank, a short section of the 
“Full text” field will appear in its place. 
On pages that show the full node, the 
summary does not appear. (To change 
how much text is taken from the “Full 
text” field to auto-create the summary, 
see Chapter 4.) 

■ Body: The node’s main content. 

Table 3.1 shows the main differences 
between articles and basic pages by 
default; however, controls near the bottom 
of each node’s “edit form” let you change 
the commenting and front-page qualities 
on individual posts. 

You see this edit form either when you first 
create a new node or when you edit an 
existing one. We’ll show you how to do 
both, which will revisit a screen that will look 
familiar to you from the section “To create 
your site’s home (front) page” in Chapter 2. 


TABLE 3.1 Comparison of Article and 

Basic Page Content Types 

Basic page 

Article 

Does not appear 
on front page 

Displays Summary section on 
front page 

Cannot add tags 

Can add tags; Drupal 
generates a page for all 
articles with the same tag 

Commenting 

disabled 

Visitors can leave comments 

No easy way to 
add a graphic 

Includes an Image field to 
add a single graphic 
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Add new content 


To create a new node: 



© Selecting a content type 



To Chicago and back 

published by admin on Sun, 10/03/2010 -16:13 
Tags: midwest travel trip report 


My trip to DuBuis, Pennsylvania 

punushfirt by admin on Sim, ifi/m/7010 -10:13 
Tags: adventure breakdown travel trip report 


1. Click “Add content” in the Shortcut bar. 
You’ll see a list of available content 
types ©. 

2. Click the content type you’d like to 
create. 

3. Write the node’s title in the Title field. 

4. Fill in the other fields in the edit form ©. 

5. Change options as desired at the bot¬ 
tom of the edit form. They are divided 
into six categories: 

► Menu settings 

► Revision information 

► URL path settings 

► Comment settings 

► Authoring information 

► Publishing options 

The rest of this section tells you about 
those options in detail. 

6. Optional: Click Preview to see what 
the node will look like without actually 
saving it. 

7. Click Save. 

GD Articles contain tags, which are words 
or short phrases separated by commas. Tags 
appear in various contexts and are linked to 
screens of similarly tagged nodes ©. For 
more about tags, see the “Categorizing Con¬ 
tent with Taxonomies” section in Chapter 5. 


Q A page of articles that have the 
“trip report” tag 
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To edit an existing node: 

1. Select a node that you want to edit, 
either by finding it on your site or by 
following the instructions in the section, 
later in this chapter, “Finding, Editing, 
and Deleting Content.” 

2. Go to the node’s edit form. Either: 

► Click the node’s title, then click the 
Edit tab. 

or 

► Hover your mouse over the node, 
then click the little gear icon that 
appears in the upper-right corner and 
select Edit ©. This icon only appears 
when the node is grouped with oth¬ 
ers, as occurs on the front page and 
elsewhere. 

You now see the same edit form as 
when you created the node, and 
you can edit and save it in the same 
way. (See “To create a new node” for 
further help.) 



© Editing a node through its pop-up menu 
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© Creating a menu item to lead visitors to a node 



©A menu item in the Main i 


To create a menu item 
that links to a node: 

1. Go to a node’s edit form. Scroll to the 
bottom, to the “Menu settings” tab. 

2. Select the “Provide a menu link” 
check box. 

3. In the “Menu link title” field, type the 
text you would like to appear as the 
link. By way of confirmation, that text 
appears on the “Menu settings” tab to 
the left ©. You can also add a Descrip¬ 
tion, which appears when visitors hover 
their pointers over the menu item. 

4. Click the “Parent item” pop-up menu 
to decide which menu this link should 
go in. By default, only the “Main menu” 
option is available, although there are 
actually several menus in Drupal. (The 
Main menu is generally at the top of the 
screen; in Drupal’s default Bartik theme, 
items in the Main menu show up as 
tabs just below the logo.) To learn more 
about menus, see the section “Direct¬ 
ing Traffic with Menus” in Chapter 6; 

to learn how to put links to nodes in 
other menus, see the section “Defining 
Custom Types of Content” in Chapter 4. 

5. The Weight pop-up menu lets you 
determine the placement of this node 
within the selected “Parent item” menu. 
Numbers on this menu range from -50 
to 50: To move an item toward the top 
of the menu, give it a lower number. 
(Chapter 6 will show you an easier way 
to organize menus.) 

6 . Click Save to create your link, which is 
shown in Q. 


till You can create your own menus to aug¬ 
ment those that come with Drupal. You will 
learn how in Chapter 6. 
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To keep track of changes 
made to a node: 

1. Go to a node’s edit form. Scroll to the 
bottom and click the “Revision informa¬ 
tion” tab. 

2. Click the “Create new revision" check 
box, and then in the “Revision log 
message” box type a summary of the 
changes you made © 

3. Click Save. 

Now you (and users who’ve gotten your 
permission, as is detailed in Chapter 7, 
“Wrangling Users”) can see the node as 
it existed in past versions © 



© Using a revision to keep track of changes to 
a node 



© A list of a node’s past versions, annotated with 
revision log messages 


What Is a Revision, and Why Should I Care? 

By selecting the “Create new revision” check box, you’re effectively making a backup of the node. 
Backups are good; they allow you to return to previous versions if an experiment goes wrong, and 
they can save your bacon when other problems occur (such as vandalism). 

I can think of only two reasons why you wouldn’t want to save revisions: first, to cover your 
tracks and hide past versions; second, for technical reasons related to disk space and database 
complexity. Except for rare circumstances, neither strikes me as terribly compelling. 

When you first install Drupal, the revisions check box is turned off for both the article and page 
content types. I prefer them to be on by default so editors don’t run the risk of forgetting to save 
a revision. Learn how in Chapter 4. 
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O Adding a URL alias to make access to the node 
more meaningful to people (and search engines) 


To make a node's URL path 
more user-friendly: 

1. Go to a node’s edit form. Scroll to 
the bottom and click the “URL path 
settings” tab. 

2. Type the desired URL path in the space 
provided O- 

The URL path is what appears after 
your domain’s name. For example, if 
you type list-of-models here, and 
your domain is example.com, the 
resulting URL to reach this node will be 
http://example.com/list-of-models. 

3. Click Save. 


GD Drupal’s natural URL path to (for 
example) the tenth node created on a site 
is http://domain-name/10. Visitors can 
reach the node through both URLs. 

GD Some characters, such as the ampersand 
(&), shouldn’t be used directly in URLs. Drupal 
will automatically translate such characters 
into a code (%2526 in this case) that makes it 
“legal,” but the URL stops being user-friendly. 
Your best bet is to stick with letters, numbers, 
hyphens, and underscores when creating URL 
aliases. 
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To permit users to leave comments 
in response to a node: 

1. Go to a node’s edit form. Scroll to the 
bottom and click the “Comment set¬ 
tings” tab. 

2. Select the Open radio button ©. 

3. Click Save. 

GD Nodes of the article content type are 
open to comments by default; those of the 
“basic page” content type are closed to com¬ 
ments by default. 

cn> Unless you change commenting permis¬ 
sions (as you’ll learn how to do in Chapter 7), 
only users who have logged in to your site 
(authenticated users) can add comments. 

GD You have considerable control over 
comment display and traffic. For details, 
see Chapter 4. 



O Permitting users to add comments in response 
to a node 
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o The “Authoring information” section, as it 
appears on a previously created node 



O Drupal’s autocomplete feature, suggesting user 
names from among your site’s authenticated users 



(D The “Publishing options” tab’s three check box 
settings 


To change the apparent 
author and date of a node: 

1. Go to a node’s edit form. Scroll to the 
bottom and click the “Authoring infor¬ 
mation” tab. 

This tab contains two fields: “Authored 
by” and “Authored on.” 

► If this is a new node, the “Authored 
by” field will have your user name in 
it, and the “Authored on” field will be 
empty. 

► If this is an existing node, the fields 
will reflect the user name of the 
person who created it, and the time 
when it was created © 

2 . To change the author, start typing a user 
name in the “Authored by” field. Using 

a Drupal feature called autocomplete, a 
list of user names that match the typed 
characters appears Q. Click the one 
you want when it becomes available. 
(The user name must already exist; if 
you try to type in one that doesn’t exist, 
Drupal will refuse to save the change.) 

3 . To change the time the node was first 
posted, enter (or change) informa¬ 
tion in the “Authored on” field. Note 
the instructions beneath the field that 
specify the required format. To use the 
current date and time, delete all infor¬ 
mation in that field. 

4 . Click Save. 


To hide a node without deleting it: 

1. Go to a node’s edit form. Scroll to 
the bottom and click the “Publishing 
options” tab ©. 

2 . Deselect the “Published” check box. 

3 . Click Save. 
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To promote a node to the front page: 

1. Go to a node’s edit form. Scroll to 
the bottom and click the “Publishing 
options” tab. 

2 . Select the “Promoted to front page” 
check box. (This check box is selected 
by default in article nodes.) 

3 . Click Save. 

To make a node appear at 
the top of the page when 
grouped with other nodes: 

1. Go to a node’s edit form. Scroll to 
the bottom and click the “Publishing 
options” tab. 

2 . Click the “Sticky at top of lists” 
check box. 

This setting is particularly useful to draw 
attention to a node’s content on the 
front page. All nodes with this setting 
appear above those without it, with 
the most recent at the top of each of 
those two groups. It’s often used on 
the front page, where some content 
should remain near the top while timely 
information (such as news items or blog 
posts) appears beneath it. 

In some themes—including Drupal’s 
default theme, Bartik—“sticky” items 
appear in a different style from other 
items ©. 



© A “sticky” item on the front page, followed by 
a non-sticky one 
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Creating Other 
Types of Content 

Drupal’s programmers and designers 
constantly dance on the line between 
complexity and ease of use. On one hand, 
administrators demand more and more fea¬ 
tures; on the other, some criticize Drupal 
for trying to do too much. 

One part of their solution has been to 
include certain functions in Drupal but 
leave them turned off by default. To take 
advantage of them you first have to turn on 
modules, as discussed in the section “To 
turn on built-in features,” in Chapter 2. The 
three types of content, and the modules 
you need to enable are: 

■ Blog posts: Let each user keep an 
online journal (Blog module) 

■ Books: Provide a structure that links 
nodes in an easy-to-read way (Book 
module) 

■ News feeds: Let your Drupal site display 
content from elsewhere on the Internet 
(Aggregator module) 

The content these tools let you create is 
somewhat like the articles and basic pages 
you already know, but it’s different in some 
ways. This section shows you how to create 
these new content types and understand 
the conceptual differences you need to 
master them. 
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To create blog posts: 

1. Enable the Blog module. 

2 . Click “Add content” in the Shortcut bar 
and then click the newly added option, 
“Blog entry" ©. 

3 . Fill out the node entry form, as outlined 
in the section “To create a new node” 
earlier in this chapter. 

The form looks exactly the same as the 
one for the article content type, except 
without the Image or Tags fields. Like an 
article (and unlike a basic page), a blog 
entry by default permits authenticated 
users to comment and is promoted to 
the front page. 

4 . Click Save. 



© The new “Blog entry” content type, the result of 
turning on the Blog module 


How Is a Blog Entry Any Different from an Article or Page? 

At first glance, the blog entry content type seems unnecessary: Articles that don’t have tags 
or images seem to be exactly the same as blog entries. 

But blogs are different in one important way: Whenever a member of your site creates 
a blog entry, the entry adds itself to that member’s personal blog page, which is available 
at http://domain-name/blog/user-ID. Further, the page at bttp-.lldomain-namelblog 
aggregates all blog entries on your site, giving visitors another way to stay informed with 
your members’ commentary. 
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© The “Feed aggregator” page, showing no 
feeds added yet 


To subscribe to content 
feeds from other sites: 

1. Enable the Aggregator module. 

2. Click Configuration in the Toolbar and 
then click “Feed aggregator” to open 
the “Feed aggregator” page ©. 

The aggregator pulls news feeds you 
specify from around the Internet and 
aggregates them into a single page. 

This module adds the menu item “Feed 
aggregator” to the Navigation menu in 
the left sidebar of non-administrative 
pages. 

The “Feed aggregator” page eventually 
shows a list of all the news items from 
feeds aggregated on your site. 

3. Optional: To add news feed categories, 
click the “Add category” link, provide 
the category’s name (and description, 

if you’d like), and click Save. When you 
create or edit a news feed, you’ll now 
have the option of adding it to a cat¬ 
egory, and later be able to display news 
feed items grouped by this category. 

If you plan to add several feeds to your 
site, it’s a good idea to put them into 
categories. For this site, for example, 
we might choose to have a “Press 
releases” category for marketing infor¬ 
mation from RV manufacturers, and an 
“Industry news” category for feeds from 
independent sources. 

continues on next page 
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4. Click the “Add feed” link. 

On the resulting page 0, provide: 

► Title: This is the title for the feed and 
will display on pages, in blocks, and 
elsewhere throughout the site to 
identify the feed. 

► URL: This is the feed’s URL, which 
needs to lead to a page with feed 
items in a format that Drupal under¬ 
stands. (For details, see the sidebar 
“How Do I Find News Feeds to Fea¬ 
ture on My Site?”) 

► Update interval: This is how fre¬ 
quently your site should receive news 
feed items. The shorter the update 
interval period, the more up-to-date, 
but also the more demands the pro¬ 
cess makes on your server (and the 
one providing the feed). 

► News items in block: This is the 
number of items that will appear in a 
sidebar, known as a block. You’ll learn 
more about blocks in Chapter 6. 

► Categorize news items: These are the 
categories you want this news feed to 
belong to, if you created categories 
earlier. (If not, you can always edit 
the feed and add them later.) You can 
make this control appear either as 
check boxes or as a multiple-select 
list; step 9 shows you where that 
setting is. 

5. Click Save. 

6 . Your site is now ready to receive news 
feed items, but you won’t see them 
until the next “Update interval” period 
passes. To force your site to grab news 
feed items at any time, click List at the 
top of the “Feed aggregator” page, 
then click the “update items” link next 
to the news feed you set up ©. 



0 Setting up Drupal to receive news feed items 
from rvbusiness.com 



O Updating items in the “News from RVBusiness” 
feed 
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© Setting permissions to allow site members to 
view items from news feeds 


Navigation 


O- 


▼ Feed aggregator 
■*■ Categories 


► Sources 


Industry 
Press releases 


© The link that leads 
to a page showing only 
news items from feeds 
in the “Industry news” 
category 


7. By default, items from news feeds are 
visible only to site administrators, not to 
site members or anonymous visitors. To 
make them available to others: 

► Click People in the Toolbar. Then click 
the Permissions tab and scroll down 
to Aggregator > View news feeds. 

► Select the appropriate check boxes 
to give access to nonmembers 
(anonymous users) or site members 
(authenticated users) ©. 

► Click “Save permissions.” 

For more information about setting user 
permissions, see Chapter 7. 

8 . On any non-administrative page, click 
“Feed aggregator” in the Naviga¬ 
tion menu in the left column, or go to 
http:/ /domain -name/aggregator, to 
view all news feed items on one page. 

Note that these items are not nodes on 
your site; clicking an item’s headline 
takes you to its source on someone 
else’s web site. 

Under the “Feed aggregator” link are 
up to two additional links: Categories 
(if you set up categories) and Sources. 
Clicking those links allows you to drill 
down and see only news feed items 
from specific categories or sources Q. 

continues on next page 
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9. To change general settings affecting all 
news feeds that you aggregate on your 
site, click the Settings tab on the “Feed 
aggregator” page. 

The Aggregator settings page 0 gives 
you controls to: 

► Say which HTML tags are permitted 
in feeds as they appear on your site. 
This is an important filter to prevent 
abuse: If all tags were permitted, 
hostile webmasters could vandalize 
your site by including malicious code 
in their sites’ news feeds. The default 
tags are safe and allow for basic 
formatting. 

► Change how many items show up in 
the source and category pages; addi¬ 
tional items appear below a “more” 
link, as 0 shows. 



0 The Aggregator settings page 


Sources 

News from RVBusiness.com 

• IValcr Open KoOHK A Good Week in Elkhart 3 day* i hour old 

• Upscale RVC Outdoor Destination* Expand* 3 days 3 hours old 

• Michigan Tourism Up; Better Time* Ahead ? 3 days 3 hours old 

RV News Service 

• Sex in RV lead* to arrest 4 days 4 hours old 

• 50-ante cell phone driving h*n? Not quite yet. any* Governors Association 6 days 3 hours old 

• Rattle over RV* heat* up with music video j iom k 1 day old 

More 

0 The default appearance of the Sources page, 
showing three items per feed 


How Do I Find News Feeds to Feature on My Site? 

News feeds are great because they automatically provide your site with content that’s both free 
and fresh. In fact, some popular (and profitable) sites are nothing but collections of news feeds! 
Practically no maintenance is needed for such sites, except to check back once in a while to make 
sure the feed source is still working. That’s all I do on my savemyhomebook.com site these days. 
The book it advertises is nearly out of print, so it’s not worth my time to write original content for it. 
News feeds let me continue to provide value to visitors interested in the subject of foreclosure. 

But you have to find news sources provided in a format Drupal’s aggregator understands, namely 
RSS (Really Simple Syndication), RDF (Resource Description Framework), or Atom. First, try 
entering a typical search term (such as RV news) in a search engine such as google.com. Then 
look through the sites it finds for pages with lists of relevant news items. When you find one you 
like, check the web browser’s location bar. Does it have the little radio-like RSS symbol ? If not, 
the content can’t be (easily) syndicated. 

But if it does, click that icon. If your browser presents you with a choice of formats, select one of 
the three that Drupal understands. The resulting page is the one you want; copy its URL from your 
web browser’s location bar and paste it into the URL field of a new feed page, as described above. 
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► Specify how long news feed items 
appear on the site before being 
removed. (Remember, no actual 
nodes are created or destroyed on 
your site when you set Drupal to 
aggregate a news feed.) 

► Determine whether to use check 
boxes or a multiple-select list to cat¬ 
egorize news feeds, as was shown in 
step 4. 

► Set how many characters of each 
news feed item will appear on your 
site. You could set this to Unlimited 
to show news feed items in their 
entirety, so that visitors don’t have to 
click the “more” link (and leave your 
site). However, news feed publishers 
often limit the length of feed items 
on their sites, so your settings might 
not affect the information that comes 
through. 
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To create books of linked content: 

1. Enable the Book module. 

2. Click “Add content” in the Shortcut bar 
and then click the newly added option, 
“Book page.” 

3. Fill out the node entry form as outlined 
in the section “To create a new node” 
earlier in this chapter. (Like articles, 
book pages by default permit visitor 
comments. However, book pages aren’t 
promoted to the front page.) 

The book concept is that each node 
can be the parent and/or child of 
another node, much like a real-world 
book contains chapters, which con¬ 
tain sections, which contain subsec¬ 
tions, and so on. Drupal book “pages” 
automatically gain links at the bottom 
leading to the previous and next pages, 
and going up to the level above. It’s not 
a perfect analogy, but it does give you 


a way to create structured texts within 
Drupal. In fact, the book structure com¬ 
prises much of the instructional material 
on the drupal.org web site. 

One thing that’s somewhat confusing 
is that you can’t create an empty book, 
then later add pages to it. Rather, the 
title of the first page that you create 
becomes that book’s title. But don’t 
worry: You can change it around later 
if you want, as you’ll see in the section 
“To change a book’s structure.” 

4. Because you turned on the book mod¬ 
ule, there’s now a new “Book outline” 
tab at the bottom of the screen 0> For 
the superuser, this tab actually appears 
in the edit form for nodes of every 
content type—articles, basic pages, 
blog entries, and anything you add later. 
You can control which types other site 
members can add to books by clicking 


Menu settings 

Nor in menu 

Book 

snone* »1 

Your page will be a part of the selected book. 

Book outline 

Not in book 

Revision information 

No revision 

URL path settings 

No alias 

No book telected. 

Weight 

0 jl| 

Pages at a given level are ordered first by weight and then by title. 

Comment settings 

Open 

Authoring Information 

By admin 


Publishing options 

Published 



Save Preview 


O The “Book outline” tab at the bottom of a node’s edit form 
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O The Books settings page 


Book 

<nor»> j^J 

of the selected book. 


Weight 

0 

Page*; at a given level are ordered first hy weight and then hy title. 


O Deciding in which book a node should go 



Parent item 



-- Fiberglass ropaxs 


— Largo fiberglass repairs 
—- Small fiberalass rooairs 

Motel repairs 

— Using pop rivets 

— Using winding 

— Sources fur materials 

Pages at a given level arc order 


Q Putting a node 
into a specific place 
within a book 


Content in the Toolbar and then clicking 
Books > Settings O- You can define 
which content type new book pages 
will be when you add them through the 
“Add child page” link, as you’ll see later. 

But back to our node. The Book pop-up 
menu lets you define whether this node 
is part of an existing book, the first page 
created of a new book, or in no book 
at all. o shows what the menu would 
look like if you’d already created a book 
called “Repair manual.” 

5. If you select an existing book from the 
Book pop-up menu, a “Parent item” 
pop-up menu appears beneath it, listing 
all the pages currently in that book. 
Choose the page you’d like to be the 
parent of the page you’re editing O' 

The Weight pop-up menu lets you order 
book pages that have the same parent, 
much like reordering subsections within 
a chapter. You’ll learn a much easier 
way to order book pages in the section 
“To change a book’s structure.” 

6 . Click Save. 

© shows a book page in a book that 
has several levels of content. 


Link to change 
position in book 


Child pages 
Previous page 


Fiberglass repairs 


Edit 


Outirm 


i Son. 10404010 • 1920 

The ahihty to repair fiberglass la one of an RV owner * mo*t valuable (kill*. Kvery town and hamlet ha* a 
dozen folks who know engines, competing with competence and price for your dollar. But when your 
'rider's roof sprinks a leak, you might have to travel hundreds of miles to find a qualified RV shop, 
which can then charge whatever it want*. 

Fortunately, fiberglass repair takes very little equipment, so there's not much up-front investment. It 
just takes patience, skill, and a little hick. 


■ large fiberglass repair* 

■ Small fiberglass repairs 


• Repair manual 


Large fiberglass repairs ■ 



© Special features of book pages 


To higher level 
in hierarchy 

Next page 

Add another book 
page (of default 
content type) 
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To change a book's structure: 

1. Click Content in the Toolbar, then click 
the Books tab to see a list of books on 
your site © 

2. Click “edit order and titles” next to the 
book you want to edit. 

© shows the resulting book editing 
screen. 

Each row represents one page in a 
book, regardless of its content type. In 
the Operations column are quick links 
to view, edit, and delete the page’s 
content. 

3. Under the Title column, you can quickly 
change the titles of any pages in this 
book by typing them in and clicking 
“Save book pages.” 

4. To move pages within a Book, grab the 
compass-like icon H and drag the page 
to its desired location. Drag a page up 
or down to change how early it appears 
in the book. You can also drag an item 
to be a “child” of another page by 
dragging it to the position directly 
beneath the parent and then dragging 
to the right. (Don’t worry if this seems 
confusing from the description—it 
immediately becomes clear when you 
start doing it.) 

A small orange asterisk appears on 
the right next to pages whose loca¬ 
tions have changed Q. When you’re 
finished moving pages around, click 
“Save book pages.” If you want to erase 
your changes anywhere during the 
process, simply close the window or go 
elsewhere in your Drupal site without 
clicking “Save book pages.” 



© The Books administration page 



© The book editing screen 


/j\ • Changes made In this table will not he saved until the form Is submitted. 

TITLE. 

+ Some—tor n—Mi _r 

4* Fitnvvt—s n»par» 

O The warning that shows the “Sources for 
materials” page has moved 
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O The Content administration page, showing 
nodes 


Q 

^ ' :V 

TYPE 

L) 

To Chicago and back 

upddtpd 

Article 

□ 

Sources for materials 

Book 

page 

O 

Using ooo rivets 

Ibxik 

page 

Q 

Using welding 

Book 

page 


O Sorting nodes 
alphabetically 
by title 


Finding, Editing, and 
Deleting Content 

Once you start creating articles, basic 
pages, blog entries, and book pages with 
wild abandon, you quickly realize how easy 
it is to lose track of what’s on your site. 

Fortunately, Drupal includes an administra¬ 
tion page that shows all your site’s content 
in an easy-to-manipulate form, and lets 
you filter it by criteria such as content type 
to find the nodes you want. Through that 
page, you can jump straight to editing 
individual pages or change certain charac¬ 
teristics of multiple nodes at once. 

To see a list of content on your site: 

1. Click Content in the Toolbar ©. 

2. Each row represents one node and 
has several links to manage that node 
directly: 

► View it by clicking its title. 

► Edit it by clicking its “edit” link. 

► Delete it by clicking its “delete” link. 

► View the user page for the node’s 
author by clicking the name in the 
Author column. 

3. By default, the page lists nodes with the 
newest at the top. But you can sort by 
any other criteria by clicking the title at 
the head of any column. In ©, for exam¬ 
ple, clicking the Title header sorted the 
list alphabetically by node title. If you 
were to click the Title header again, the 
list would appear in reverse alphabeti¬ 
cal order by title. 

continues on next page 
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4. You can filter the list so that only (for 
example) nodes of the “book page” 
content type appear. To do so: 

► Choose whether you want to filter the 
list by content type or status. (Other 
options might be available as you add 
or enable other modules.) If you want 
to filter on multiple criteria, select any 
criterion to filter on first. You’ll have 
an opportunity to filter further on 
other criteria after you’ve set the first 
filter. 

► Click Filter. The screen now shows 
only those nodes that meet your 
stated criterion. Once you’ve selected 
your first filter term, the options will 
change to Refine, Undo, and Reset. 

► Continue adding criteria, clicking 
Refine after each one ©. To go back¬ 
ward one step in the filtering process, 
click Undo. To return to seeing the full 
list of nodes, click Reset. 

To perform bulk changes on 
multiple nodes at once: 

1. Select the check boxes of those nodes 
you want to affect. To select all nodes 
showing on the screen, select the 
check box at the top of the column, 
next to the Title header. 

2. Under “Update options,” click the pop¬ 
up menu and choose the operation you 
want to perform ©. (The list of available 
options may grow as you install and 
enable modules.) 

3. Click Update and Drupal will change 
the selected nodes. 



© Filtering to show only book page nodes that 
have been published 


UPDATE OPTIONS 

Publish selected content 
Publish selected content 


Unpublish selected content 


Update 


C Demote selected content from front page 

1 Make selected content sticky 

Make selected content not sticky 

L Delete selected content 

TYPE 

Book page 

□ 

Large fiberglass repairs 

Book page 

□ 

Repair manual 

Book page 

a 

Metal repairs 

Book page 

a 

Using pop rivets 

Book page 

□ 

Sources for materials 

Book page 

a 

Using welding 

Book page 


© Unpublishing three nodes 
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Customizing 

Content 


Drupal suffers from the “blind men describ¬ 
ing an elephant” syndrome. In that Indian 
fable, one man touches the trunk and 
declares that an elephant is like a tree 
branch; another touches the tail and says 
an elephant is like a rope; a third touches 
an ear and says the elephant is like a great 
leaf; and so forth. The thing observed is 
seen by its parts, according to the needs of 
the individual. 

Since Drupal’s audience has historically 
been software developers, that’s translated 
into strong support for text and add-on 
programming. Two areas where it’s not 
been as capable are in creating content 
types with custom fields, and in supporting 
graphics and text styling within nodes. 

Fortunately, both areas are getting bet¬ 
ter. This chapter tells you how to create 
more flexible content using tools that 
are available today. However, a constant 
stream of new solutions passes through 
the library of contributed modules at 
drupal.org/project/modules. For details 
on how to find and use them, see Chap¬ 
ter 9, “Extending Drupal with Modules.” 


In This Chapter 

Defining Custom Types of Content 74 

Putting Images and Styled Text 

in Content 85 





Defining Custom 
Types of Content 

Now we come to one of Drupal’s most 
useful features: custom content types. 
Through them you can move far beyond 
built-in types and into a world bound only 
by your imagination. For example, an 
“employee” content type could include 
fields for position and salary, and a “cata¬ 
log page” content type would have fields 
for prices, colors, and sizes. 

Nearly all Drupal sites today have cus¬ 
tom content types. But amazingly, Drupal 
succeeded for years without this feature. 

It was first available in 2005 through a 
contributed (non-core) module called 
Flexinode, which was replaced by Con¬ 
tent Construction Kit (CCK) in 2006. Now, 
Drupal 7 incorporates most of CCK in 
its core. 

Although this section teaches how to cre¬ 
ate new content types, the instructions are 
essentially the same if you want to edit an 
existing content type, such as an article 
or basic page. If you do so, be aware that 
changes to an existing content type will pri¬ 
marily affect only newly created nodes of 
that content type. If you add an age field to 
an existing content type, for example, and 
require that the age field contain a value, 
then existing nodes without a value in that 
field will be unaffected—at least until you 
go to edit the node. At that point, you’d be 
prompted to fill in the required field. 
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© Naming and describing a new content type, 
with the pointer indicating how to change its 
machine name 


To create a new content type: 

1. Click Structure in the Toolbar and then 
click “Content types.” 

2. Click “Add content type” to go to the 
content type edit form ©. 

Most of this form is familiar to you, 
because it looks somewhat like the one 
you use to create and edit nodes, which 
you learned about in Chapter 2, “Estab¬ 
lishing Your Drupal Site.” 

But there’s an important difference. 
Changes you make on a node edit form 
affect only a single node; changes you 
make on the content type edit form 
affect every node of that content type. 
You’re creating a template for future 
nodes. 

3. Complete the two fields that give the 
content type its identity: 

► The Name field is where you type the 
“human-readable” name of the con¬ 
tent type. Drupal automatically cre¬ 
ates a “machine name” that converts 
spaces to underscores, and upper¬ 
case characters to lowercase charac¬ 
ters. (Drupal uses this machine name 
internally.) However, you can choose 
to change the machine name by click¬ 
ing the Edit link in this area ©. 

► The optional Description field is 
where you add explanatory text that 
appears on the “Add new content” 
page to help content editors select 
the right content type. 

continues on next page 
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4. Complete the “Submission form set¬ 
tings” section, which controls the 
appearance of several parts of the 
node edit form for this content type: 

► The “Title field label” field comes 
with the default value of Title. I like to 
change it to something more descrip¬ 
tive, such as Model name 0 . You 
can’t leave this field blank. 

► The “Preview before submitting” 
setting determines whether node 
creators see a Preview button at the 
bottom of the node edit form. If Dis¬ 
abled is selected, they see only the 
Save button; if Optional is selected, 
they see both the Save and Preview 
buttons; and if Required is selected, 
they see only the Preview button and 
are allowed to save a node only after 
previewing it. 

► The “Explanation or submission 
guidelines” field lets you add a note 
that appears at the top of the node 
edit form for the benefit of node cre¬ 
ators and editors 0 . 



0 Settings that affect the node edit form, with 
some options changed for our “Sunader Fans” site 


Create RV Model ® 


Home > Add new content 


Please ensure the model isn't already in the site before you add it! 

Model name * 


©A portion of the node edit form, reflecting 
changes we made 
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© Publishing options settings on the content type 
edit form 



Q The display settings options for a content type 


5. Click the “Publishing options” tab © 
to set default values for that part of the 
node edit form. To learn about these 
settings, see Chapter 3, “Creating and 
Managing Content.” 

6 . Click the “Display settings” tab © 
to choose whether a node shows its 
author and date of creation © taken 
from the “Authoring information” sec¬ 
tion of the node edit form. Exactly how 
this information displays is defined by 
programming in the active theme. 

continues on next page 


1986 Adventure-II 

Vbw Edit 

puhfcWW By admin on Tun. 1(V0V?01Q - i? 4fl 

The 19-foot Adventure-II holds a special place in the hearts of collectors. 


© The title and beginning of a node as it appears 
when the “Display author and date information” 
check box is selected 
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7. Click the “Comment settings” tab ©to 
control how visitors can “talk back” in 
response to nodes: 

► The “Default comment setting for new 
content” pop-up menu lets you set 
whether comments will be allowed at 
all on nodes of this content type. (You 
can change this setting on individual 
nodes, however.) 

Open means comments are allowed. 

Closed prevents further comments 
from being added, but displays any 
that were already there. 

Hidden means all existing comments 
will be hidden, and no more will be 
allowed. 

► Threading affects whether text is 
indented so that conversations 
are easier to follow O. When not 
selected, all comments appear at 
the same indentation level. This 
“flat” format is graphically clean but 
(sometimes) makes it hard to follow 
individual conversations, which are 
known as “threads” ©. 

► The “Comments per page” setting 
defines how many comments appear 
before the reader has to click links 
at the bottom of the page to see 
more. A low value makes comment 
pages display more quickly, because 
there’s less information for Drupal 

to put together and for the server to 
push through the Internet. I generally 
don’t find the delay too onerous, so 
I usually change it to the maximum 
value (300). 



© Changing the comment settings to affect 
visitors’ interaction with a content type 


1986 Adventure-II 

nuMaahnd h. ariftin t 

mTua. lO/Oft/JOlO • 136? 

The 19 -foot Adventure-11 holds a special place in the hearts of collectors. 

Comments 


admin 

tub, «a/tK/70ia 

Just for the record... 

ixrrnalink 

1 haw a Sun radar Adventure* II. and 1 lava ill:) 

jink* 

You do? You lucky! 

permslmk 

You have one. admin? Wow! Where did you ew find it? 

Jim Bob 

Tub KMJ6/3O10 - 

Yeah, tell us! 

paravalmk 

like Janice, I\e bom n>tn* to go one of these for ‘fomer*. 


Key, admin, wanna *dl touts? ;) 




© Comments displayed as a threaded list, making 
it clear that the third comment is in response to 
the first 
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1986 Adventure-II 

OuW»h«ri b» alrnnon Tur HVD6C010 136? 

The 19-foot Advcnturc ll holds a special place in the hearts of collectors. 


Comments 


■drain 

IMrtjisllnk 


Just for the record... 

I haw* SunneW Admnture-ll, and I low* ill:) 


jartiee 

Tua. HMMAOK 
parmalmk 


You do? You lucky! 

You haw one, admin? Wowl Where did ywi ewr find it? 


Jim Bob 

Tub. M/MOOIO • 

1340 

parmalibk 


Yeah, tell us! 

lika Janice, I'vi been trying » ga one of their tot ‘forever*. 

Hey, admin, wanna sdl yxnmf ;) 
mew 


O Comments displayed as a flat (unthreaded) list, 
which is prettier but harder to follow 


► The “Allow comment title” check box 
determines whether commenters can 
write their own subject lines. When 
unselected, or if a commenter fails 

to provide a title, Drupal automati¬ 
cally creates one using the first few 
words of the comment. For example, 
for a comment that reads “I agree 
very strongly with your post,” Dru¬ 
pal will generate the (somewhat 
awkward) subject line “I agree very 
strongly with.” 

► The “Show reply form on the same 
page as comments” check box deter¬ 
mines whether visitors see a com¬ 
ment form directly below the node’s 
content or have to click an “Add new 
comment” link to see it. Your choice 
makes a difference in how many com¬ 
ments you get; it’s surprising how 
many people won’t bother to click! 

To encourage more comments, leave 
this check box selected. 

► “Preview comment” options work 
very much like those for a node’s 
“Preview post” options. When you 
select Required, commenters are 
forced to read through what they 
wrote before being allowed to post. 

In practice, selecting Required means 
that some commenters will fail to 
realize that they have to preview 
their posts before saving them and 
will simply lose their comments by 
going to another screen. On the other 
hand, some administrators believe 
the Required selection cuts down on 
frivolous, misformatted, and hot¬ 
headed comments. 

continues on next page 
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8 . Click the “Menu settings” tab O to 
control where you can put menu links 
to nodes of this content type when you 
create or edit nodes. See the section 
“To create a menu item that links to a 
node” in Chapter 3 to understand how 
your choice here affects users. You 
can always add links from any menu by 
directly editing it: For details, see Chap¬ 
ter 6, “Improving Access to Content.” 

9. When you’ve made all necessary 
changes, click “Save content type.” 



o Controlling where nodes of this content type 
can get automatic menu links 


Deleting Content Types: Harder Than It Sounds 

By now you might have noticed that it seems as easy to delete a content type as it is to create 
one. Easier, in fact. You can delete them on both the content type edit form and the page that lists 
content types. 

But beware: Nodes of a content type become “orphans” when you delete that content type, avail¬ 
able for view but not editing. Only sophisticated monkeying around in the database will make them 
work again. 

Also note that content types that are created by modules, such as “blog entry,” don’t have “delete” 
links in the usual places. Instead, you get rid of them by turning off the relevant module. Nodes 
of such content types also become orphaned when you do this, so be sure to delete them as 
you learned in the section “Finding, Editing, and Deleting Content” in Chapter 3. You can then 
re-create those nodes as a different content type. (Unfortunately, Drupal doesn’t currently offer 
any way to change a node’s content type.) 
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To change a field's display 
and input options: 

1. In the Toolbar, click Structure and then 
click “Content types.” 

2. Click the “manage fields” link next to 
the content type you want to affect. 
Besides being a place to add fields, on 
this screen Q you can also: 

► Delete a field by clicking its “delete” 
link, if it’s a type of field that can be 
deleted. However, you can’t delete 
fields that modules create or the 
node’s title field (shown in € by 
the name we gave it earlier, “Model 
name”). 

► Edit the field’s basic criteria by click¬ 
ing the “edit” link. We discuss the 
many options on the resulting page in 
the next step. 


► Change the order of fields by clicking 
and dragging their T icons. Note that 
you have to click Save after reorder¬ 
ing fields: You’ll lose all reordering 
changes if you click other links on this 
page before clicking Save. 

► Change a field’s type, for example 
from List to Long text, by clicking the 
link that shows the current type. For 
the Body field in ©, that’s “Long text 
and summary.” (It’s rare that you’ll 
want to do this.) 

► Change a field’s “widget”—that is, the 
selection tool for entering data in the 
field. Examples of widgets included 

in Drupal include check boxes, radio 
buttons, pop-up menus, and text 
fields; contributed modules may add 
other widgets (such as a date selec¬ 
tion calendar). In D, the widget is cur¬ 
rently “Text area with a summary.” 

continues on next page 


RV Model ® 


EDIT COMMENT DISPLAY 


Home . Administration » Structure ■ Content types * RV Model 


Show row weights 


LABEL 

NAME 

FIELD 

WIDGET OPERATIONS 

+ 

Model name 

title 

Node module element 


+ 

Body 

body 

Long text and summary 

Text area with a summary edit delete 

+ 

Add new field 






field. 

• Select a ftefci type • jJ 

• Select a widget • »| 


Label 

Field name (a-z. 0-9. J 

Type of data to store. 

Form element to edit the data. 

+ 

Add existing field 






So loct an wool mg tidd 

d 

boioct a wxjgol *j 


label 

Field to share 


Form element to edit the data 


o] 


Save 


© The screen where you manage a content type’s fields 
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3. Click the “edit” link to go to the field 
settings form. 

Options on this form vary consider¬ 
ably, depending on the field’s type and 
widget. (Our example is of the Integer 
field type.) In fact, some field types and 
widgets break these options into more 
than one screen, in which case you’ll 
simply have to fill out the first screen, 
then click “Save field settings” before 
moving on to the second. 

The screen shown in © is for a newly 
created field that’s intended to hold an 
integer. (You’ll learn howto add fields 
in the next section, “To add fields to a 
custom content type.”) The form’s top 
part is for changing the field’s basic 
information, including: 

► The Label, which you entered when 
you first created the field. 

► The “Required field” check box, which 
determines whether to force node 
editors to enter a value in this field. 

► The “Help text,” which will appear 
near the field as a guide for node 
editors. 

► The Minimum, Maximum, Prefix, and 
Suffix allow you to limit the range 
of values the user can enter, or to 
change how the field appears when 
displayed. For example, you could 
put a dollar sign before the value so 
a “5” appears as “$5.” 

There are many other options, depend¬ 
ing on the field type and widget 
selected. For example, the “Long text 
and summary” field type includes a 
“Summary input” check box that lets 
you permit (or forbid) entry of a sum¬ 
mary section. For more about summa¬ 
ries, see the “Gaining More Control of 
Individual Nodes” section in Chapter 3. 



© The field edit form, where you change a field’s 
basic information 


82 Chapter 4 








4. Fill out the “Default value” parts of the 
field edit form. Whatever data you enter 
here will appear prefilled in the field 
when someone later creates a node 
that contains it. 

5. Complete the “Number of values” pop¬ 
up menu that allows you to decide how 
many values you can have in a multiple 
value field. 

Multi-value fields can be a hard concept 
to grasp, and it’s best explained with 
a few examples. Such a field might be 
used to show: 

► The names of gold, silver, and bronze 
medalists in a content type for Olym¬ 
pic sports events. (In that case, you’d 
set the “Number of values” pop-up 
menu to 3.) 

► The instruments that a musician plays 
in an “orchestra member” content 
type (with the pop-up value set to 
Unlimited). 

6 . When you’ve finished modifying the 
field’s settings, click “Save settings.” 
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To add fields to a custom 
content type: 

1. Click Structure in the Toolbar and then 
click “Content types.” 

2 . Click the “manage fields” link next to 
the content type you want to change. 

3 . Put the human-readable name in the 
Label area and the machine-readable 
name in the “Field name” area. Select a 
field type, which determines the kind of 
data this field can contain. 

Generally speaking, Drupal’s field 
types o fall into five categories: 

► Text, including Text, Long text, and 
Long text and summary 

► Numbers, including Integer, Float, 
Decimal, and Boolean 

► Selection lists 

► Files 

► References, for example Term refer¬ 
ence. (Downloadable modules permit 
references to other entities, such as 
nodes and users.) 

Other field types may become avail¬ 
able as you add modules, as Chapter 9 
describes. 


4 . Once you’ve indicated the type of data 
this field will contain, the widget pop-up 
menu becomes available and reflects 
the widgets for the selected field type. 
Choose the one you want and then 
click Save. 

5 . The “Field settings” screen displays, 
where you specify details that are 
specific to the field type you chose. 

This section is broken into two screens: 
The first affects this field in every con¬ 
tent type where it appears, while the 
second is specific to this content type. 
Complete the field settings form as was 
described in the section, “To change a 
field’s display and input options” earlier 
in this chapter. When you’ve provided 
all required details, click “Save field set¬ 
tings.” You will return to the list of fields 
for this content type. 

6 . Put fields in the order you want by 
clicking and dragging their + icons. 
Click Save when finished. 


■ 

Add new field 1 

■ 

Model VW 

field. ToOot yo*- 

VilaW a ealfl type - kl»| 

Koine* A wing At »| 


label 

field name (a-r, 0-9, J | 

^ -.11 

form element to edit the data 


+ Add exlitinq field 

Ha 



• Select an eodrtingMd- 1 


• Select a widget • 


Label 

field to share 

"teoer 

form element to edit the data. 

■ Savt 


List (numeric) 

UelQMet) 
long test 




Long text and atmmary 

Term reference 




o Types available for custom fields in a content type 
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Putting Images and 
Styled Text in Content 

Drupal creator Dries Buytaert gives a 
“State of Drupal” keynote presentation at 
every semi-annual DrupalCon conference 
(drupalcon.org) to talk about progress 
during the last six months and plans for the 
next six. At that talk he also presents the 
results from his web poll on buytaert.net 
that asks, “What improvements does 
Drupal need most?” Lately, the same item 
has been at the top of Drupal developers’ 
wish list: better media handling. 

With Drupal 7, that wish finally came true— 
at least, for graphics. In previous versions, 
you had two options. You could upload the 
graphic to the server, figure out where it 
was being stored, and write some HTML to 
put the graphic where you wanted; or you 
could find, download, and figure out a half- 
dozen modules to speed the process. 

Under the guidance of Dries and long-time 
developer Angela Byron (known on the 
Drupal.org site as “webchick”), Drupal 7’s 
developers made a special effort to 
incorporate those modules into Drupal 
itself. The results aren’t perfect, but they’re 
definitely encouraging. As you learned in 
Chapter 3, you can now attach graphics 
to articles with the click of a button; this 
chapter tells you how to attach graphics 
to nodes of any content type and how to 
place graphics with greater precision than 
Drupal naturally allows. Finally, you’ll learn 
how to add text styles such as bold and 
italics without needing to resort to HTML 
code. 
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To add an image to article nodes: 

1. To add an image to an existing article 
node, go to the node and click the Edit 
tab. Otherwise, create the article node 
as you learned to do in Chapters 2 
and 3. 

2. Complete the Title and Body fields as 
usual and make all desired changes to 
the settings tabs at the bottom of the 
page. 

3. Click the Browse button next to the 
Image field to get a file-selection dialog 
box. Navigate to the graphics file you 
want to add and select it. 

4. Click the Upload button. Depending on 
your connection speed, you might have 
to wait a while until the file uploads to 
your server. When it’s finished, you’ll 
see a small (thumbnail) version of the 
image, and the Upload button will 
become labeled Remove. 

5. Optional: Add a description of the 
photo in the “Alternate text” field. This 
text will be useful to those visitors, such 
as blind people, who use non-graphical 
web browsers ©. 

6 . At the bottom of the node-creation 
form, click Save to save the node. You’ll 
view the newly changed article, with 
your full-size graphic at the top ©. 


- n-aby-dork-parked.;pg (1*1.21 KH1 Kimm 
Alternate teat 

Mttkarariw l»x»’ fJ* tw*tr» ata-Uq aM 

TM« taxi wi» b« uud by iriwn rudm, learch engine*, ot when the image cannot be loaded. 
Upload an image to go with chit afficlr. 


© The node-creation form after adding an image 
and some alternate text 


Trip report: Oberiin, Ohio to Coming, New York 



Well, it was a touch trip but a rewarding one. We Matted out tatty on Saturday, the rain driving hard- 
Tin »o glad we got that leaky window fixed! (Thanks {or (ending me the trim we needed. Boh.) 

We made pretty good rinse getting out, and decided we'd stop In Eric and bang out at a casino. And If 
they had parking, we'd May over. Why not? We were an vacation! 

That worked oat OX: We did tuy over, and can necammend the la! to the north of the casino. It'sufe. 
<|usrt, and pleasant. Just be sate not to park too dose to the sodium lights - they're awfully height! 

Then we decided to take a major detour to Sarah's childhood home near Buffalo 
'rio* mpmpori Orw Nana York 

© An article with an added image 
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© Adding an image field to a content type 



O The “field settings” screen 


To enable images in nodes 
of any content type: 

1. Go to the list of content types by click¬ 
ing Structure in the Toolbar and then 
clicking “Content types.” 

2. Click the “manage fields” link next to 
the content type you want to affect. 

3. In the “Add new field” area, enter the 
human-readable and machine-readable 
names for the image field you’re going 
to add, as was decribed in the section 
“To add fields to a custom content type.” 

4. In the area labeled “Type of data to 
store,” change the pop-up menu to 
Image. The widget pop-up menu to its 
right should also change to Image auto¬ 
matically 0. 

5. Click Save. You now see the “Field 
settings” screen 0 , which offers two 
choices: 

► “Upload destination” allows you to 
choose whether to make the images 
accessible to everybody who can find 
the URL (Public files) or only to those 
people who have special permission 
(Private files). It’s an advanced sub¬ 
ject, and rare that you would want to 
specify the latter. Suffice it to say that 
if you don’t have a specific reason to 
select “Private files,” leave this selec¬ 
tion on its default, which is “Public 
files.” (On some Drupal installations, 
“Public files” is the only option.) 

► “Default image” lets you select an 
image that will appear in this field for 
every node of this content type that 
doesn’t have its own image. 

6 . Click “Save field settings” to arrive at 
the settings page for this field, which 
we’ll discuss in the next section, “To 
control image criteria.” 
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To control image criteria: 

1. When you create an image field, you 
eventually come to a second screen full 
of settings for that field. 

To change these settings after a field 
has been created, you need to return 
to that second field settings screen. To 
do so, first go to the “Content types” 
list screen by clicking Structure in the 
Toolbar and then clicking “Content 
types.” Click “manage fields” next to the 
content type that contains the field you 
want to affect. Then click the “edit” link 
next to the relevant field ©. 

In either case, you’ll see the settings 
page for this image field Q. 

2. We described what many of these fields 
are in the section “To change a field’s 
display and input options.” Some of the 
options that are especially relevant to 
images include: 

► “Allowed file extensions” lets you 
specify which file types are permis¬ 
sible in this field. The defaults (png, 
gif, jpg, jpeg) cover most graphic 
types that can be displayed in web 
browsers, but you might want to add 
other types (such as svg) for special 
applications. 

► “Maximum image resolution” and 
“Minimum image resolution” let you 
ensure that graphics aren’t too big 
or small. People will still be able to 
upload larger graphics—Drupal will 
simply resize them down to fit these 
values. However, your site will reject 
attempts to upload graphics that are 
smaller than the minimum size. (If 
Drupal attempted to resize too-small 
graphics, the result would be an ugly, 
low-quality image.) 



© Reaching the second field settings page from 
the list of fields 



© The second field settings screen for images 
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► “Maximum upload size” lets you 
limit how much disk space each 
image may occupy. If you don’t enter 
anything, the limit will be defined by 
settings in the php.ini file in your 
AMP stack. For more about this, see 
Chapter 1, “Getting Drupal Up and 
Running.” 

► “Enable Alt field” and “Enable Title 
field” check boxes allow anyone who 
adds an image to also include text 
that appears in the HTML code that 
surrounds that image. As the help 
text explains, the alt field appears in 
places where the image itself can’t be 
loaded, such as in non-graphical web 
browsers; the title field determines 
what appears when a visitor hovers 
the cursor over the image. 

3. Click “Save settings” to return to the 
list of fields for this content type. The 
changes you made will affect all nodes 
of this content type that you edit or cre¬ 
ate, but they won’t affect existing nodes. 

GD It’s a good idea to set the first value 
(which defines the width) in the “Maximum 
image resolution” field to 800 or less. If you 
don’t, people will upload graphics that are 
wider than visitors’ screens. When visitors look 
at the node, that graphic will force them to 
scroll horizontally to see the whole thing, and 
it could make your site’s design ugly and hard 
to read. 

GD If you leave the “Maximum upload size” 
setting blank, you’ll probably allow people 
to upload very big files, which could quickly 
fill your hard drive and will probably appear 
inconveniently large in your site. A value of 
2 MB or 4 MB should be sufficient for most 
purposes. 

GD Enabling the Alt and Title fields is good 
practice, because it improves your site’s acces¬ 
sibility for people with limited vision and those 
browsing the web with unusual devices. 
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To include images in 
content using HTML: 

1. Find and copy the URL of the image 
you want to use. One way of doing this 
is to go to the web page that contains 
it, put your pointer over the image, 
right-click (or Control-click if you have 
a one-button mouse), and select Copy 
Image Location. 

2. Edit the node where you want to place 
an image by going to it and clicking the 
Edit tab. 

3. In the node’s Body field, type 
the HTML code <img src ="URL" 

alt ="description" />, replacing URL 
with the web address you copied. You 
can style the image further using addi¬ 
tional HTML, if you like. 

4. Choose Full HTML from the “Text 
format” pop-up menu 0 . 

Warning: Switching to the Full HTML 
text format opens a security hole if 
anyone else has permission to edit this 
node. For more information about text 
formats, see Chapter 5, “Making Con¬ 
tent Interactive.” 



0 Displaying a remotely hosted image in the body of a node 
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What About Other HTML Tags? 

The act of changing the text format 
from Filtered HTML to Full HTML opens 
the door to any and all HTML stylings, 
including text styles such as <b> (bold) 
and <font>. 

However, your HTML might not appear 
as you expect. Drupal themes format 
pages using an extensive set of CSS 
directives, which can substantially 
change the appearance of even the 
most basic HTML tags. 


5. Scroll to the bottom of the screen and 
click Save. The image now appears in 
the body of the node. 

GD To link to files that exist elsewhere on 
your Drupal site, you don’t need the http:// 
domain-name part of the URL. In fact, includ¬ 
ing that part slows down image retrieval, since 
your Drupal site is forced to look up its own 
address! A typical code in that case would be 
<img src="/sites/default/files/moby 
-dork-01.jpg">. 

GD I recommend that you reference only 
graphics that are hosted on your own server. 
For one thing, you have more control over the 
images and know they won’t suddenly change 
or disappear; for another, it’s considered impo¬ 
lite (and possibly illegal) to “hotlink” graphics 
that are hosted elsewhere, unless you have 
explicit permission from their owners, because 
the remote server pays the bandwidth charges 
for the image to appear on your web site. 

By the same token: Once a file is on your 
server, you can display it in any node, not just 
the one to which it’s attached. 
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To style text using a rich-text editor: 

1. In a web browser, go to the Wysiwyg 
project page at drupal.org/project/ 
Wysiwyg. 

2. Download and install the latest Drupal 7 
version of the Wysiwyg module, using 
the techniques described in the “To 
install, enable, and configure modules” 
section of Chapter 9. 

3. Click Modules in the Toolbar. 

4. Scroll to the bottom of the page. Select 
the Wysiwyg check box and then click 
“Save configuration” © 

5. This module doesn’t actually add rich- 
text tools to your site. Instead, it con¬ 
nects your Drupal site to many rich-text 
editors that are available in the wider 
web-development world. You now need 
to download and install one of those 
packages. 

Click Configuration in the Toolbar and 
then click “Wysiwyg profiles.” 

6 . On the resulting page you’ll see a list of 
rich-text editors that work with the Wysi¬ 
wyg module. You’ll need to download 
and install one of them: I’ll demonstrate 
using the first one on the list, the popu¬ 
lar CKEditor. 

Click the Download link O to go to the 
CKEditor site ©. (You’ll need to return 
to this page for the instructions it con¬ 
tains, so I recommend that you open 
the CKEditor site in a new browser 
window or tab.) 
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© Enabling the Wysiwyg module 



O The link to download the CKEditor package 



©The CKEditor home page with the pointer 
indicating the package’s download link 
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Wysiwyg profiles • 
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o Selecting CKEditor for all times when users 
enter text in the Filtered HTML format 


7. You’ll now download and unpack 
CKEditor. 

► On Mac or Windows: Click the 
“Download zip” button. Find the 
downloaded package on your com¬ 
puter and double-click it to uncom¬ 
press it. (If you have problems doing 
so on a Windows computer, see the 
sidebar “Help! I Can’t Uncompress 
the File!” in Chapter 1.) 

► On *nix using the command-line 
interface: Copy the URL linked 
from the “Download tar.gz” button. 

In a terminal program, type wget 
URL. When the package has fin¬ 
ished downloading, type tar -xzvf 
downloaded-package-name. 

8 . Return to the Wysiwyg profiles page to 
determine where you’ll need to put the 
files you just downloaded and uncom¬ 
pressed. Move the files as directed. 

Since we’re using CKEditor, we’ll need 
to create a new “libraries” directory 
inside /sites/all/modules. 

9. Reload the Wysiwyg profiles page, 
either using your browser’s Reload func¬ 
tion or by clicking Configure in the Tool¬ 
bar and then clicking “Wysiwyg profiles.” 

The page has changed to now allow 
you to select which editor to use for 
each text format that’s active on your 
site. (For more information about text 
formats, see Chapter 5.) You could also 
load other rich-text editors by clicking 
the “Installation instructions” link to 
expose the instructions you saw on this 
page earlier. 

10. In the pop-up menu next to “Filtered 
HTML,” select CKEditor Q and then 
click Save. 


continues on next page 
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11. The rich-text editor now appears when¬ 
ever you have an opportunity to enter 
Filtered HTML text, for example when 
creating a basic page ©. 


GD As you might guess from the long list of 
rich-text editors on the Wysiwyg configuration 
page, there are lots of debates in the web- 
development community about the advan¬ 
tages and disadvantages of each. Links from 
the Wysiwyg project page at drupal.org/ 
project/wysiwyg lead you to those discus¬ 
sions and additional resources for understand¬ 
ing this complex topic. 

Ill* You can direct your site to use the 
rich-text editor when entering text in any text 
format, but I generally use it only for Filtered 
HTML. When I enter something in Plain Text 
format I usually don’t want any rich-text for¬ 
matting at all, while I reserve Full HTML format 
for times when I want to explicitly provide 
formatting in code. 


Edit Basic page Where to buy parts ® 


Home • Where to buy parts 

Title *_ 

Whan to buy parts 


Body (Edit summary) 
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White our bttte Survaders *w« popular In their time, that time was a long time ago. Sadly, parts are now hard to come by. Here are a tew sources: 

• Craig * u*t Of noursm it's at ctaosliM org 

• Junkyards You're more likely to find parts for the truck portion than the camper portion, but you rmvor know.... 


© Editing a node with CKEditor’s controls active 
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Making Content 
Interactive 


In the first four chapters of this book you 
learned how to create a solid, information- 
filled site. But you’ve only scratched the 
surface of what Drupal can do. Now we’re 
going to start working with features to: 

■ Let users have a more active role in the 
site by taking part in polls and discus¬ 
sion forums. 

■ Group nodes into categories. 

■ Define and select allowed input formats 
for content. 

■ Change how uploaded images appear 
in varying contexts. 

In short, you’ll learn features that add 
depth to nodes, letting them interact more 
with each other—and your users. 

Any time we mention users, we have to 
talk about user security. Drupal allows you 
to make features available to all users, 
to a subset, to administrators, or to just 
the superuser. This chapter includes brief 
instructions for granting those permissions; 
for complete control, see Chapter 7, “Wran¬ 
gling Users.” 
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Enabling Interactive 
Content Types 

In Chapter 3, “Creating and Managing 
Content,” you learned how to extend your 
Drupal site beyond articles and basic 
pages, first by enabling the Book and Blog 
modules, and then by adding news feeds 
via the Aggregator module. Now we con¬ 
tinue in that vein by enabling and configur¬ 
ing modules that let you: 

■ Create polls, in which each user is 
permitted only one vote, with the totals 
automatically tallied. 

■ Establish forums where your users can 
talk amongst themselves in a con¬ 
venient and familiar “bulletin board” 
environment. 

Both of these features work especially well 
when limited to authenticated users—that 
is, those who have created and logged in 
to an account on your site. In fact, these 
features are unavailable to anonymous 
(non-member) users unless you specifically 
let them in. 

To create polls: 

1. Click Modules in the Toolbar. Enable the 
Poll module, then scroll down and click 
“Save configuration.” 

2. You now have access to a new content 
type called “poll.” To create a poll node, 
click Add content > Poll. The poll edit 
form appears. 

3. Type a name for the poll in the Question 
field, which is like the Title field in other 
content types. 
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Create Poll 



© The poll edit form partially filled out 



© The poll from C as visitors with voting 
permission see it 


4. Enter options in the Choice fields ©. 

► You can “fake” votes by typing a num¬ 
ber in the “Vote Count” column. At 
first glance this feature seems devi¬ 
ous, because it allows you to stack 
the deck for options that you want 

to win. But it also has honest appli¬ 
cations, for example if you wanted 
to preserve the vote count from a 
survey that you started offline or on 
another web site. 

► Initially, the form presents only two 
spaces for choices. To add another, 
click “More choices.” Repeat as 
necessary. 

5. In the “Poll Settings” option, the Active 
selection indicates that you’re still 
soliciting votes; you can turn off vot¬ 
ing at any time by changing the radio 
button to Closed. Doing so doesn’t 
unpublish the poll. Rather, users who 
visit a Closed poll see the poll’s results 
instead of a list of choices. 

By default, the poll will continue until 
you click the Closed radio button. But 
you can make Drupal close the poll at 
a future point in time by selecting an 
option (other than Unlimited) from the 
“Poll duration” pop-up menu. 

6 . Make any desired changes to the 
tabbed section of the edit form. (For 
help, see Chapter 3, “Creating and 
Managing Content.”) By default, polls 
are promoted to the front page, with 
open commenting. 

7. Click Save. You now see your poll as 
visitors with voting permission see it ©. 
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To manage polls: 

1. By default, only users with the admin¬ 
istrator role may vote in polls. To allow 
others to vote, click People in the 
Toolbar 0. Then click the Permissions 
tab and scroll down to the Poll section 
to select the check boxes next to “Vote 
on polls.” Scroll to the bottom and click 
“Save permissions.” 

For more details about permissions and 
roles, see Chapter 7. 

Visitors vote by clicking the radio 
button of choice, then clicking Vote. 
Anyone who has voted already, or 
who doesn’t have permission to vote, 
sees a bar-graph representation of the 
results instead of the poll questions 0 . 

2. To see how people voted, click the 
Votes tab. You’ll see only votes cast 
by individuals, not those faked by the 
administrator 0. Votes from anony¬ 
mous users (if permitted) appear with 
the user’s Internet Protocol (IP) address 
in the Visitor column, or ::l if the vote 
is from the machine on which the site is 
hosted. 



0 Setting permissions to allow anonymous and 
authenticated users to vote on polls 


Toyota owners: How have you handled the axle issue? 

Mew Ed* VMM 


Bought my Sun ruder with the one-too axle 


Bought a used one-ton axle and upgraded my Sunrader 

47* (to <**•*) 

Still have the half-too axle 

11% (S vet**) 


Other (give details In comments) 

7% (3 vet*,) 



Total notes: 43 

Cancel your vote 

WKwtmw 


O Poll results with a count of 43 votes, whether 
by individual voters or faked by the administrator 



©Vote records showing how authenticated and 
anonymous users voted 
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To set up discussion boards (forums): 

1. Click Modules in the Toolbar. Enable the 
Forum module, then scroll down and 
click “Save configuration.” 

The Forum module requires that the 
Comment and Taxonomy modules 
also be enabled (they are by default). 

If they’ve become disabled for any 
reason, Drupal will display a screen 
offering to enable them when you click 
Continue. 

2. A new Forums link appears in the 
Navigation menu in the left column. 
Clicking that link leads to the forums 
themselves. To reach the Forums 
administration page, click Structure in 
the Toolbar and then click Forums. 

This page shows a list of forums and 
containers you created, which at first 
contains only one forum, “General 
discussion” Q It also has links to add 
forums and containers, which we’ll 
discuss in the section “To create forums 
and containers.” 


continues on next page 


Forums ® 


Home • Administration • Structure 

Forums contain forum topics. Use containers to group related forums. 

0 More help 

+ Add container + Add forum 


Show row weights 


NAVE WEIGHT OPERATIONS 

General discussion edit forum 



Q The Forums administration page as it appears before you make any changes 


Making Content Interactive 99 






3. The Settings tab leads to a screen 
where you can change three facets 
of your forums’ appearance © 

► Hot topic threshold: Determines 
how many comments a topic needs 
to receive before its icon changes 
to show that it’s unusually active, or 
“hot” ©. 

► Topics per page: Says how many top¬ 
ics appear without the visitor having 
to click a “next” link at the bottom of 
the screen. Smaller numbers allow 
the page to load faster but could 

be inconvenient to visitors in busy 
forums. 

► Default order: Lets you change how 
a forum’s page of topics initially 
appears to visitors. (Once there, they 
can change the order of topics on the 
page by clicking headers at the top of 
each column, as you saw in the sec¬ 
tion “To see a list of content on your 
site” in Chapter 3.) 

4. By default, only users with the admin¬ 
istrator role may create, edit, or delete 
forum topics. To grant these permis¬ 
sions to other roles, click People in the 
Toolbar and then click the Permissions 
tab. Select the appropriate check boxes 
to grant permissions, then scroll to the 
bottom and click “Save permissions” O- 

For more details about permissions and 
roles, see Chapter 7. 



© The forum settings screen 


Fiberglass repairs 

♦ Add new Forum topic 
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© Icon difference between topics with five and 
six comments when the “Hot topic threshold” is 
set to five 
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□ 

0 

Delete any forum topic content 

□ 

□ 
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O Allowing authenticated users to start forum 
discussions 
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The Strange Language of Forums 

Containers, forums, topics... Drupal’s forum system introduces a new set of terms, some of which 
seem redundant. Here’s what they ail mean, going from the largest unit (the forum system as 
a whole) to the smallest (comments). 

The page at http-J/domain-name/forum lists all forums and containers that you created. Contain¬ 
ers, as the name implies, can contain either forums or other containers. You might, for example, 
have a container named “Car manufacturers” inside of which are the forums Toyota, Chevrolet, 
and Kia. 

But forums can also contain other forums, so the Toyota forum might have Prius, Yaris, and Corolla 
forums inside it O. Someone could post a message inside any of those subforums (Prius), but also 
post directly to the top-level forum (Toyota). 

However, nobody can post a message inside the container that encompasses them all (“Car manu¬ 
facturers”): Containers can’t directly hold messages. 

Oh, and those messages? They’re simply nodes of the content type “forum topic,” and show up 
alongside articles and basic pages in the list of content you see when you click Content in the 
Toolbar. Comments made in response to forum topics are treated like any other comments within 
Drupal and appear in the Comment administration list. 


Forums 

♦ Add nrw Forum topio 


I Forum 

Too* 03 

Post# 

Lost post | 

Car marulacturora 

Toyota 

0 

0 

n/a 

Corolla 

0 

0 

n/a 

Pnu* 

0 

0 

n/a 

Yana 

0 

0 

n/a 

Chevrolet 

0 

0 

n/a 

Kia 

0 

0 

n/a 

Repair advice 

Fiberglass repairs 

0 

0 

n/a 

MotoJ repairs 

0 

0 

n/a 


O A forum structure with containers and forums in a multi-level structure 
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To create forums and containers: 

1. Click Structure in the Toolbar and then 
click Forums. 

Here you can create forums (where 
discussions take place) and containers 
(which group forums together). We’ll 
first create a forum and then create a 
container for it. But Drupal’s system 
for forums is flexible: You can create 
forums and containers at will and then 
reorganize them later if you prefer, as 
you’ll see in the section “To manage 
forums.” 

2. Click the “Add forum” link and complete 
the form on the resulting page © 

The Parent and Weight pop-up menus 
are handy for categorizing and reor¬ 
dering forums as you create them. 
These are very similar to the Book and 
Weight pop-up menus you see when 
you create book pages, as the section 
“To create books of linked content” in 
Chapter 3 described. As with books, it’s 
often easier to categorize and reorder 
forums after you’ve created them, as 
you’ll see in the section “To manage 
forums.” 

When finished, click Save. 

3. To add a container, click the “Add con¬ 
tainer” link and fill out the form, which 
is nearly identical to one for creating a 
forum. When finished, click Save. 

After you’ve created a forum or con¬ 
tainer, you return to the list of forums, 
with your new item in it ©. To make 
any changes to an item, click the “edit 
forum” or “edit container” link to its right. 



o Creating a forum 



©The forum list page, after creating a forum and 
a container 
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© Moving the “Fiberglass repairs” forum so it’s 
inside the Repairs container 


To manage forums: 

1. Click Structure in the Toolbar and then 
click Forums. 

2. To rearrange items in the list, or to 
make one item contain another, grab 
the compass-like icon and drag it to 
the desired location ©. The process is 
similar to the one demonstrated in the 
section “To change a book’s structure” 
in Chapter 3. After making changes, 
click Save. 

3. Visitors with appropriate permis¬ 
sions can visit your forums by click¬ 
ing the Forums link in the Navigation 
menu, or by going directly to http:// 
domain-name/ forum. 

4. There are two ways to post a forum 
topic: 

► Click “Add new Forum topic” on any 
forum page, then select the desired 
forum from the Forum pop-up menu 
on the resulting page. If you clicked 
that link while viewing a specific 
forum, the Forum pop-up menu will 
already contain its name. Fill out the 
node edit form as usual and then 
click Save. 


or 

► Create a new node of the content 
type “Forum topic” by clicking Add 
content > Forum topic. Once on the 
“Create Forum topic” page, select the 
desired forum from the Forum pop-up 
menu, fill out the node edit form as 
usual, and then click Save. 
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Categorizing Content 
with Taxonomies 

Many Drupal beginners overlook a power¬ 
ful feature of Drupal: its system of labeling 
content with categories, known as tax¬ 
onomy. That’s because Drupal taxonomy is 
difficult to understand in the abstract and 
its terminology can be confusing at first. 

But a hypothetical example clarifies both 
its use and its value. 

Let’s say your site sells T-shirts, and you’ve 
set up a node for each T-shirt design. You 
have two taxonomy vocabularies set up: 
Color (with the terms Black, Gray, and 
White) and Size (with the terms Small, 
Medium, and Large). You “tag” each T-shirt 
node with terms from those vocabularies, 
according to the shirt’s availability. A visitor 
to your site can then click a Medium link 
and see a page of all your shirts of that size, 
or click Gray to see all shirts of that color. 

You’ve already used taxonomies in this 
chapter without realizing it: When you 
create a forum or forum container, Drupal 
actually adds its name as a term in the 
Forum vocabulary. Further, Drupal comes 
with a vocabulary called Tags to hold terms 
you enter when creating or editing a node 
of the article content type. 

Now you’re going to learn how to create 
your own vocabularies and fill them with 
terms that will make your site easier to 
navigate and more useful to visitors. 
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Taxonomy 



© The Taxonomy settings page, showing both the 
Forums vocabulary (enabled by the Forum module) 
and the default Tags vocabulary 



© A completed vocabulary edit form 


vUltni 



To set up a taxonomy's vocabulary: 

1. To see a list of active vocabularies, go 
to the Taxonomy administration page 
by clicking Structure in the Toolbar and 
then clicking Taxonomy ©. 

2. Click “Add vocabulary” to go to the 
vocabulary edit form ©. The Descrip¬ 
tion is not displayed directly by Drupal 
at all. But it’s available to developers, so 
it might show up when you install mod¬ 
ules or add custom programming. (For 
information about installing modules, 
see Chapter 9, “Extending Drupal with 
Modules.”) 

3. When finished, click Save. You now see 
your new vocabulary in alphabetical 
order on the Taxonomy page ©. You 
can move it to another place by 
dragging the compass-like icon 


© The Taxonomy page, with the new vocabulary 
in place 
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To use a vocabulary in content: 

1. Click Structure in the Toolbar and then 
click “Content types.” Click “manage 
fields” next to the content type whose 
nodes you’d like to categorize. 

If you need help with creation or 
management of content types, see the 
“Defining Custom Types of Content” 
section in Chapter 4, “Customizing 
Content.” 

2. Add a new field, as you learned to do in 
the “To add fields to a custom content 
type” section in Chapter 4. Select “Term 
reference” as the field type ©• 

You have three options for the widget: 

► Select list: Presents terms as either 
a multiple-select list, or as a pop-up 
menu if you’ve specified that users 
can select only one option © © 

(You can control how many options a 
user may select on the field settings 
page.) When presented as a multiple- 
select list, users can choose multiple 
options by pressing Command (Mac), 
Control (Windows), or Shift (both) 
while clicking. 

In either case, you’ll need to manu¬ 
ally add terms to the vocabulary to 
provide the options from which users 
will select. (You’ll learn how to do 
that in the section “To add terms to 
a vocabulary.”) 



© Adding a vocabulary field to a content type 



© Appearance 
of the term entry 
field when you 
select “Select 
list” and allow 
users to enter 
only one term 



© Appearance 
of the term entry 
field when you 
select “Select 
list” and allow 
users to enter 
more than one 
term 
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Camper component 

On/a 

0 Air conditioning 
O (-old water 
O Doors 
O Heater 
O Hot water 
O Oven 
O Range 
O Roof 

O Shower 
O Storage 
O Toilet 
O Windows 

Part of the camper that this advice helps fix 


0 Appearance 
of the term entry 
field when you 
select “Check 
boxes/radio 
buttons” and 
allow users to 
enter only one 
term 


► Check boxes/radio buttons: Presents 
terms as check boxes, or as radio but¬ 
tons if you’ve specified that users can 
select only one option 0 0 

► Autocomplete term widget (tagging): 
Lets users add terms to a vocabulary 
by typing them in when editing a node 
with that vocabulary available O- As 
they type, Drupal suggests existing 
terms by presenting a list of terms that 
begin with the letters entered. 

3. When you’ve finished configuring the 
vocabulary, click Save. 


Camper component 

□ Air conditioning 

□ Cold water 

□ Doors 

□ Heater 

□ Hot water 

□ Oven 

□ Ranqe 
Q Roof 

□ Shower 
Q Storage 

□ Toilet 
Q Windows 

Part of the camper that this advice helps fix 


0 Appearance 
of the term entry 
field when you 
select “Check 
boxes/radio 
buttons” and allow 
users to enter 
more than one 
term 


Camper component 

ol 

Part of the camper that this advice helps fix 

O Appearance of the term entry field when you 
select “Autocomplete term widget (tagging)” 
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To add terms to a vocabulary: 

1. Go to the Taxonomy administration 
page by clicking Structure in the Tool¬ 
bar and then clicking Taxonomy. 

2. There are two ways to add terms to a 
vocabulary. Next to the vocabulary you 
want to augment, either: 

► Click “add terms.” 
or 

► Click “list terms” and then click the 
“Add term” link. 

3. On the resulting term edit form, the only 
field you’re obliged to fill in is Name O- 

The text in the Description field appears 
both in news feeds that your site pub¬ 
lishes automatically, and at the top of 
the page that Drupal presents when 
someone clicks the term. The URL alias 
lets you define an alternative way to 
get to that page, in the form of http:// 
domain/url-alias. Whether you indi¬ 
cate a URL alias or not, the page URL 
will be in the form of http-.Z/domain/ 
taxonomy/term /number. 

4. Click the Relations link for greater con¬ 
trol over this taxonomy term G 

The “Parent terms” field lets you set up 
taxonomy terms as a complex hierarchy. 
For example, let’s say we wanted to 
group our terms into larger categories, 
so that Toilet and Shower would both 
be under a Water category. If we’d 
planned that from the beginning, we 
would create the Water category first, 
then select it as the parent when creat¬ 
ing the Toilet and Shower categories. 

One advantage to this system is that 
you can set multiple parents for a 
term. For example, a “Hot water” entry 
could have both Water and Heating as 
parents. 



O Adding a term to the “Camper components” 
vocabulary 


▼ iRelatjonsj 

Parent Irnns 

Air conditioning 

Cold water 

Doors 

Heater 

lights 

Oven 

Range 

Roof 

Shower 

Storage 

Toilet 

Windows 

Weight * 

0 

Terms are displayed in ascending order by weight. 


G Controls to change term 
relationships and positioning in 
a vocabulary’s list of terms 
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O The page that appears when a user clicks the 
Water link, showing all nodes tagged with that 
taxonomy term 


Keeping Tags on Taxonomies 

Even people who are completely com¬ 
fortable with taxonomy concepts can 
get bogged down on the details of their 
implementation. Often it’s a matter of 
choice whether to divide information by 
content type or taxonomy term, and the 
Parent feature complicates the matter 
further. 

If your site requires complicated tax¬ 
onomy, I recommend that you plan it 
first on paper—but expect to change 
it as you go. Start with a fairly simple, 
non-hierarchical system: You can always 
change its organization later. If you 
intend to allow visitors to tag nodes 
freely, keep an eye on what terms they’re 
adding by occasionally clicking the “list 
terms” link next to the relevant vocabu¬ 
lary on the Taxonomy administration 
page. 


The Weight pop-up lets you rearrange 
terms so they appear in your chosen 
order rather than alphabetical order. 

GD Although Drupal permits multi-word 
terms (for example, “Trip reports”), it’s a good 
idea to limit yourself to single-word terms 
when you have the choice. There are some 
situations where terms appear right next to 
each other, and it can be hard to tell the dif¬ 
ference between a two-word term and two 
one-word terms. 

GD As with forums, it’s much easier to set 
“Parent terms” and Weight after you’ve cre¬ 
ated your terms, because Drupal provides a 
graphical interface to do so on the “List terms” 
page. To use it, click the “List terms” tab and 
drag terms around as the section “To manage 
forums” described. However, you can’t set 
up multiple parentage (as in our “Hot water” 
example) using this graphical system. 

To view taxonomy terms in content: 

1. When you create or edit a node that 
allows entry of taxonomy terms, you’ll 
have the option to choose terms that 
relate to the node’s content. The 
interface varies depending on settings 
for the taxonomy’s vocabulary. For 
clarification, see the section “To set up 
a taxonomy’s vocabulary" earlier in this 
chapter. 

2 . When visitors view nodes that have 
been tagged, its terms generally appear 
near the node’s main content. (Exactly 
where they appear depends on your 
site’s active theme.) Clicking a term 
leads to a page that shows the Sum¬ 
mary section of all nodes tagged with 
that term Q. 
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Mastering Text 
Formats 

A lot of Drupal’s genius is hidden from 
view, for example in its security safeguards. 
One such safeguard is its handling of user 
input, which counteracts attacks made 
on a site through “tricky” input such as 
PHP code or malformed HTML. By default, 
Drupal blocks such input by throwing 
away any part that seems unusual, allow¬ 
ing only a few tried-and-true HTML tags 
via its “Filtered HTML” format. A second 
format, “Full HTML,” allows all HTML tags. 
That’s potentially more dangerous because 
it could (for example) allow an attacker 
to redirect visitors to another site, but it’s 
often useful when you’ve allowed input 
only from trusted sources. A third option 
allows entry of code in the programming 
language PHP, providing unbridled flexibil¬ 
ity at an even greater cost of security. 

You can also add your own text formats 
for special purposes—if, for example, 
you’d like to allow only the HTML tags 
for bold and italic styles. Further, Drupal’s 
core (and some contributed modules) 
extends text formats with additional 
filters that format input automatically. 

For example, the htmLawed module 
(drupal.org/project/htmLawed) adds 
filters to make users’ HTML entry more 
secure and “correct.” 
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To select a text format for 
an individual node: 

1. Go to the node’s edit form, either by 
creating a new node or by editing an 
existing one. 

2 . Below the area where you enter the 
node’s “Full text” content is the “Text 
format” pop-up menu ©. Three are 
available by default: Filtered HTML 
(which limits available tags to a small 
handful), Full HTML, and Plain text 
(which strips all HTML content while 
converting web and email addresses 
into clickable links). 

Just below the pop-up menu is text that 
briefly clarifies features of the currently 
selected text format. For a consider¬ 
ably longer description, click the “More 
information about text formats” link to 
the right of the pop-up menu. 

3 . When you’ve finished editing the node, 
click Save. Drupal applies your text 
format choice to both the Summary 
and Full text of the node when it is 
displayed. 


To change the default text 
format selection: 

1. Click Configuration in the Toolbar and 
then click “Text formats” to reach the 
Text Formats administration page. 

2 . Click the compass-like icon SS next to 
the text format you’d like to be the 
default selection and drag it to the top 
of the list, then click “Save changes” ©. 

All new nodes from now on will show 
this selection by default in the node edit 
form. (Text formats of existing nodes 
remain the same.) 


Text format >Mnd More information about text formats 

• Web addresses turn into link* Automatically. 

iiil HTML "r 

• Allowed h i text I <strnng» <hlnr kquofes erodes <ul» <ol> <k> edls <di> <dd> 

• tines and r anwj iopwi ■ A itnmatirally 


© Selecting a text format from the three default choices 


/! * Changes made in this table will not be saved until the form is submitted. 


NAME 

ROLES 

OPERATIONS 

Plain ttxr 

All rotes may use this format 

configure 

tJ Drag to rc order 

anonymous user, authenticated user, administrator 

configure disable 

•J. Full HTML 

administrator 

configure disable 


Save changes 


© Changing the default text format to Plain text 
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To add a new text format: 

1. Click Configuration in the Toolbar and 
then click “Text formats.” Click “Add text 
format” 0. 

2 . Enter a name for the text format in the 
Name field. This will appear alongside 
Filtered HTML and Full HTML in the 
list of text formats on the Text Format 
administration page and in the “Text 
format” pop-up menu when you edit 

a node. 

3 . Select which user roles have access 
to this text format. The options are 
discrete. That is, even though authenti¬ 
cated users usually have more access 
to your Drupal site than anonymous 
users, here you can grant text-format 
access to anonymous users without 
automatically granting it to authen¬ 
ticated users. For more information 
about user permissions, see Chapter 7. 

4 . Select desired options in the Filters 
section. They are: 

► Limit allowed HTML tags: Lets you 
permit only tags that you specify. 
Selecting this check box reveals 
controls at the bottom of the screen 
where you can specify permitted tags. 

► Display any HTML as plain text: 

Shows HTML exactly as it’s entered, 
without applying it to the text. For 
example, a tag such as <br /> would 
be converted to &lt;br /&gt;, where 
&lt; displays on the page as the less- 
than bracket and &gt; displays as the 
greater-than bracket. 

► Convert line breaks into HTML (i.e., 
<br> and <p>): Prevents paragraphs 
from running together. 

► Convert URLs into links: Allows 
content contributors to simply 



0 Creating a custom text format 
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type web and email addresses 
that become clickable without the 
addition of any HTML code. As a 
result, the typed text http://www. 
example.com effectively becomes 
<a href="http://www.example.com" 
title="http://www.example.com"> 
http: //www. exam pie. com</a>, 
and user@example.com becomes 
<a href="mailto:user@example. 
com">user@example.com</a>. 

► Correct faulty and chopped off HTML: 
Redeems a number of sins, for exam¬ 
ple by closing improperly entered 
tags. Without this filter enabled, an 
errant tag could affect all content that 
follows it on the page. 

Both the “PHP filter” in Drupal’s core 
and some downloadable modules add 
other filters. (The “Filters/editors” cat¬ 
egory at drupal.org/project/modules 
contains most of the downloadable 
modules that add text format filters.) For 
information about the PHP filter mod¬ 
ule, see the section “To permit PHP in 
content” later in this chapter. 

5 . If you have multiple filters enabled, you 
might find that they’re not acting as 
you expect because they’re processing 
text in the wrong order. 

For example, let’s say you wanted to 
teach someone HTML by letting them 
enter a simple URL like http://www. 
example.com and receive the HTML 
code <a href="http://www.example, 
com" title="http://www.example. 
com">http://www.example.com</a>. 

To do so, you’d want the text to first go 
through the “Convert URLs into links” 
filter, and then the “Display any HTML 
as plain text” filter. But if they go in 

continues on next page 
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the reverse order, the results are quite 
different! 

In such instances, you can change the 
order in which text format filters are 
applied by grabbing the compass-like 
icons . and dragging the text formats 
to their desired locations ©. 

6 . If you selected the “Limit allowed HTML 
tags” check box, you’ll see a vertical tab 
at the bottom of the page where you 
can change that option’s settings Q. 
The settings are: 

► Allowed HTML tags: This is where 
you list all tags that you want to per¬ 
mit content contributors to use. 

► Display basic HTML help in long filter 
tips: Provides substantial help text if 

a content contributor clicks the “More 
information about text formats” link 
when editing a node, as the section 
“To select a text format for an indi¬ 
vidual node” described. 

► Add rel-'nofollow" to all links: Adds 

a small amount of text to link HTML in 
order to reduce the effectiveness of 
spam activity on your site. 

Spammers often attempt to post gar¬ 
bage content that contains a popular 
search phrase linked to the URL for 
a site they’re advertising. Their goal 
is to make search engines (such as 
Google and Yahoo) relate their sites 
to those popular search phrases, so 
that when people search for those 
phrases, the spammers’ sites will 
show up near the top of the list. 

But most popular search engines 
discard links that have the 
rel="nofollow" tag, so such trickery 
on your Drupal site won’t work when 
you’ve selected this check box. 



©Changing the order of filters on a text format 



© Options available when you select the “Limit 
allowed HTML tags” check box 
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7 . If you selected the “Convert URLs into 
links” check box, you’ll see a vertical 
tab at the bottom of the page where 
you can specify how long URLs may 
appear. 

The link works the same regardless 
of this setting: Only the text displayed 
changes. For example, if you set the 
“Maximum link text length” value to 15 
and then type in the URL http://www. 
example.com/path/index.html, Drupal 
will display the link as http://www. 

exam _(The http:// is considered part 

of the URL’s character count.) 

8 . When you’ve set up the text format as 
you wish, click “Save configuration.” 

To permit PHP in content: 

1. Go to the Modules page by clicking 
Modules in the Toolbar. 

2 . Select the check box to enable the 
“PHP filter” module, then scroll to the 
bottom of the screen and click “Save 
configuration.” 

3 . Click Configuration in the Toolbar and 
then click “Text formats.” Along with 
Filtered HTML, Full HTML, and any text 
formats you created, there is now a text 
format “PHP code”; however, nobody 
(except the site’s superuser) has permis¬ 
sion to use it when posting content. 

4 . To make the PHP code text format avail¬ 
able to other users, click the “configure” 
link. The resulting page is similar to the 
one you see when creating a new text 
format, as was demonstrated in the sec¬ 
tion “To add a new text format.” Select 
check boxes to allow users of specific 
roles to use the PHP code text format. 
(For more information about user roles 
and permissions, see Chapter 7.) 

continues on next page 
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5 . Permitted users may now enter PHP 
code in a node by choosing “PHP code” 
from the “Text format” pop-up menu Q. 

There are subtleties in Drupal’s PHP 
handling, and errors can damage or 
even break your site. Therefore, it’s 
imperative that everyone with PHP 
posting access read the information 
available by clicking the “More informa¬ 
tion about text formats” link. 







Text format 

. No HTML tJ 

• Web page a 

• Lines and d 

1 Plain text 1 | 

dres 

Itica 

Plain text 

Filtered HTML 

Full HTML 

Preferred text format 

PHP code [\ 


Q Applying the PHP code text format via 
a menu that also includes a custom text 
format and the three default text formats 


Danger Zone: "Full HTML" and "PHP code" Text Formats 

You can’t permit PHP input without talking about security, because PHP is the very rock on which 
Drupal is built. Exposing it is like exposing the thoracic cavity for open-heart surgery: necessary 
and useful, perhaps, but not for beginners. 

How dangerous is it? At the very least, someone could learn the details of your server’s configura¬ 
tion with the simple line <?php phpinf o(); ?>, and then take advantage of any weaknesses found 
within. Worse, someone could do all sorts of tricks using something called code injection, essen¬ 
tially bypassing Drupai’s security measures and giving orders directly to your MySQL database. An 
attacker could delete all your site’s content, take it offline, and change the superuser’s password 
with just a few lines of code. 

Even if there’s no malice intended, a small PHP error could crash your site or destroy its data. 

So you have to be sure that your code is correct in a general sense and that it conforms to what 
Drupal expects. Some guidelines are in the “More information about text formats” link next to 
the “Text format” pop-up menu; further details are at drupal.org/handbook/customization/ 
php-snippets. 

Less risky—but still unsafe—is the Full HTML text format. Although someone can’t reach into 
Drupal’s innards with the same recklessness, it still exposes your site to such exploits as cross-site 
scripting (XSS), which could be used to (for example) steal private data from your site’s users. 

The twin solutions? First, enable the PHP filter module only if absolutely necessary. (You could also 
delete the Full HTML text format, although its lower risk makes that less crucial.) Second, check the 
text formats’ permissions to ensure that they’re available only to those user roles that need them— 
and can use them responsibly. 
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Mastering 
Image Styles 

When you create an article-type node, you 
have the option to upload an image. While 
you’re editing the node, it appears in a 
small “thumbnail” format; when visitors see 
it on the page, it’s been resized to be no 
larger than 480 pixels square. 

You can change both of those settings and 
even add your own. You could do this in 
Drupal 6, but only if you uploaded and con¬ 
figured the ImageAPI, ImageField, Image- 
Cache, and FileField modules. Drupal 7 
incorporates the important parts of those 
modules into its core and simplifies their 
interfaces. 

Drupal’s system of image styles makes 
graphic fields consistent throughout the 
site: If you change the size of the “large” 
image style, then the appearance of every 
image with that style will change automati¬ 
cally. (It doesn’t change images that you’ve 
embedded using HTML, however.) Drupal 
holds onto the original image, so you don’t 
need to worry about upsampling if you first 
shrink an image and then later enlarge it. 
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To change image styles in content: 

1. Edit the display settings for an image 
field. For our example, we’ll change 
the settings of the Image field in the 
article content type. To do so, click 
Structure in the Toolbar and then click 
“Content types.” Then click “manage 
display” in the Article row ©. You now 
see the page where you can change 
the appearance of fields in the article 
content type ©. 

For further help editing a field’s set¬ 
tings, see the section “Defining Custom 
Types of Content” in Chapter 4. 

2 . Click the small gear icon in the 
Image field’s row. A set of controls 
appears ©. 

3 Click the “Image style” pop-up menu 
to change how images in this field will 
appear. (You can also affect what will 
happen when visitors click the image 
by changing the “Link image to” pop-up 
menu.) Click Update. 

4 . Click Save. All images in that field will 
be resized to reflect your changes the 
next time a visitor views them. 



© The link to manage field display for the article 
content type 






• CV5TCW MTtlNC* 
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© The Manage Display screen for the article 
content type 
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© Controls to change the appearance of the 
Image field 
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O The image styles management page 



© Creating a new image style 


Edit sU/u_blxk_and, white style > 



U»2*'« »,« 


© The page where you change the image style’s 
effects 



© Setting criteria for the Crop effect 


To create or edit image styles: 

1 Click Configuration in the Toolbar and 
then click “Image styles” to go to the 
image styles management page ©. 

2 . To add a new style, click the “Add 
style” link. 

3 . On the resulting page, enter the name 
for your new style and click the “Create 
new style” button ©. 

The next page provides a preview of 
your changes, an opportunity to change 
the image style’s name, and a place to 
apply effects to your image style Q. 
We’ll focus only on this last section. 

4 . Click the “Select a new effect” pop-up 
menu. The options are: 

► Crop: Cuts off portions of the image 
that are larger than the size you 
specify. When you select this option 
and click Add, a screen of settings 
appears where you can decide which 
of nine regions is most important to 
keep; the image will be trimmed from 
the edge that is farthest from that 
“anchor” © 

► Desaturate: Removes color informa¬ 
tion from the image—in other words, 
makes it a black-and-white graphic. 

► Resize: Forces the image to be the 
width and height you specify on its 
settings screen. This option may 
“stretch” the image so it appears 
taller or flatter than before. 

► Rotate: Spins the image from its cen¬ 
ter point. This effect’s settings screen 
lets you specify the degree of rotation 
and the color that will appear in areas 
vacated by the corners of the images. 
There’s also a Randomize check box, 
which applies a random rotation 

continues on next page 
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angle and makes the “Rotation angle” 
setting meaningless © 

► Scale: Shrinks the image to fit in 
the dimensions you specify, while 
maintaining its proportions. Selecting 
the “Allow upscaling” check box tells 
Drupal to enlarge smaller images to 
the specified size. 

► Scale and crop: Forces the image 
to fit into your specified dimensions 
by shrinking to the point that one 
dimension fits, then trimming off the 
other dimension from the center as 
needed. 

For all effects except Desaturate (which 
has no settings screen), click the “Add 
effect” button when you’re finished 
providing the effect’s settings. 

5 . The Effects list now shows which effects 
will be applied to images of this style 
and in what order O. The order could 
make a difference, particularly if your 
list of effects includes cropping; to 
change it, grab the compass-like 

icon and drag the effects into your 
preferred order. 

6 . When you’ve made all the changes you 
want, click “Update style.” 

To edit an existing image style, return 
to the image styles management page 
and click “edit” next to the style you 
want to change. 

GD Use the Scale option when you want to 
resize a graphic but retain the entire image in 
its original proportions. Crop and “Scale and 
crop” may remove portions of the image, while 
Resize may change its proportions. 

GD Selecting the “Allow upscaling” option 
when scaling an image will give images a con¬ 
sistent size, but will also make most smaller 
images look worse. 



© Setting criteria for the Rotate effect 



O A list of effects to apply to an image style 
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Improving Access 
to Content 


Librarians have a saying: “You don’t need 
to know everything. You just need to know 
how to find out about everything.” As the 
administrator for your Drupal site, you’re 
the librarian, with power to make informa¬ 
tion easy to find and understand... or not. 

Drupal gives you tools to organize your 
content, most importantly: 

■ Search 

■ Menus 

■ Blocks 

The first two are fairly easy to explain, and 
in fact you already learned a little about 
menus in the section “To create a menu 
item that links to a node” in Chapter 3, 
“Creating and Managing Content.” 

Blocks, on the other hand, have far more 
options. They are in essence a layout sys¬ 
tem, albeit one that’s corralled into speci¬ 
fied block regions, defined by the theme. 
Despite their limitations, blocks give you 
a lot of opportunities to turn a generic 
theme into a presentation of content that’s 
distinctly yours. 


In This Chapter 


Making Content Searchable 
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Making Content 
Searchable 

Google shocked the Internet in 1998 by 
proposing a minimalist search interface as 
an alternative to Yahoo’s sprawling home 
page. Rather than categorizing content 
into numerous squirrel-holes, as Yahoo did, 
Google presented visitors with a simple 
search box—and changed the direction of 
the web for the better. 

The simple search box continues to 
dominate how people find content, and 
your Drupal site comes with one already 
installed. Drupal shields you from most 
of the complicated inner workings of its 
search engine, but it does give you a few 
points of control, should you decide to take 
advantage of them. 

Specifically, you can change how the 
site prepares content for searching; the 
minimum length of search terms; and how 
important various aspects of content are in 
deciding which to list first. 
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© Setting search permissions to allow anonymous 
users to search the site, and authenticated users 
to perform both simple and advanced searches 


INDEXING STATUS 

ST* of (He site has been indexed. There are J l«ems left to Index. 

Re-index Mte^ 

© Forcing Drupal to review all nodes on the site 
to make their contents available for searching the 
next time cron runs 


To make your site searchable: 

1. Drupal comes with its Search module 
enabled by default, but only allows the 
superuser and those users with the 
administrator role to search the site. 

To grant that permission to others, 
click People in the Toolbar and then 
click Permissions. Scroll down to the 
Search section and select the appro¬ 
priate check boxes ©. When finished, 
scroll to the bottom and click “Save 
permissions.” 

For further information about user 
roles and permissions, see Chapter 7, 
“Wrangling Users.” 

2 . Although the site appears to be search¬ 
able, searches find only text that Drupal 
has processed, or indexed. That index¬ 
ing occurs every time Drupal’s periodic 
housekeeping processes run—which, 
by default, is once every three hours. 

However, you can force Drupal to index 
content immediately by running cron, a 
program that performs periodic mainte¬ 
nance tasks on your site. To do so: 

► Click Reports in the Toolbar and then 
click “Status report.” 

► Click the link under “Cron mainte¬ 
nance tasks” labeled “You can run 
cron manually.” 

If you want to force Drupal to delete the 
old index and re-index the entire site: 

► Go to the Search settings page by 
clicking Configuration in the Toolbar 
and then clicking “Search settings.” 

► Click the “Re-index site” button ©. 
Drupal will re-index your site the next 
time that cron runs, whether that hap¬ 
pens manually or at the end of cron’s 
three-hour period. 
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To perform simple and 
advanced searches: 


1. In Drupal’s default configuration, a 
search box is in the left column for 
all users with search access ©. A 
search page that includes advanced 
search options is available at http:// 
domain-name/ search. 

To perform a search, simply enter the 
desired text and click the magnifying- 
glass icon or press Return. Drupal will 
look for nodes that contain all the 
words you specify, in any order ©. The 
resulting page shows: 

► The search box, containing the text 
you searched for. (You can perform 
another search here as well.) 

► A link that reveals controls for 
advanced searches. 

► A short snippet from each search 
result (hit), with the sought-after term 
highlighted. 

► Other information about the node 
that contains the hit. 

To see the full node, click the hit’s title- 
in this case, “Welcome to the Sunrader 
enthusiasts site!” 


Q, 


© Drupal’s search box 



© The resulting page from a search with one “hit” 
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2 . From here, users with “Use advanced 
search” permission can perform 
complex searches by clicking the 
“Advanced search” link Q. Newly 
revealed options let them: 

► Search for words logically separated 
by or, so a search with Sunrader 
parts in this field will search for 

Sunrader or parts. 

► Search for phrases. 

► Search for pages that contain a 
certain term, but that don’t contain 
another term. 

► Search only within nodes of certain 
content types. 

GD Searches find full words only: A search 
for under or stand won’t find a node contain¬ 
ing the word “understand.” 

GD Case doesn’t matter, so a search for 
pizza returns the same results as one 
for Pizza. 

GD Searches must contain at least one 
“positive” search term. That is, you can’t find 
all pages that lack a certain term. (Drupal 
displays an error if you fill out only the 
“Containing none of the words” field.) 

GD All the features of the “Advanced 
search” form are actually available within 
the simple search form as well: You just 
have to know how to construct advanced 
search queries manually. For example, the 
search in G would be http ://domain 
-nc7me/search/node/Sunrader%20 
type%3Aarticle%20love%200R%20like 
%20-Winnebago%20%22company%27s%20 
history%22. However, such searches are still 
only available to those users with permission 
to access Advanced search. 

GD If you want to perform the same search 
on user profiles rather than nodes, click the 
Users tab above the search results. From there 
you can change the search to continue to 
search for users. 
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To further control search 
results and indexing: 

1. Click Configuration in the Toolbar and 
then click “Search settings” to see the 
Search settings page Q. 

2 . The previous section “To make your 
site searchable” tells how to use the 
“Re-index site” button to force Drupal to 
re-catalog the contents of all nodes in 
your site for searching. 

3 . The “Number of items to index per 
cron run” setting determines how 
many nodes and comments Drupal will 
index automatically the next time that 
cron runs. You generally won’t need to 
change this setting unless either: 

► You run a site that averages over 100 
posts or comments per cron run (in 
which case you should increase the 
value). 

or 

► Your server has difficulty indexing as 
many items as you indicated (in which 
case you should decrease the value). 

4 . The field “Minimum word length to 
index” dictates how short search terms 
may be: Users who enter a shorter 
search term get an error; if they enter 

a combination of valid and too-short 
words, Drupal ignores the too-short 
ones. It’s rare that you would have a 
reason to change the default value of 
3, unless you have a lot of two-letter 
abbreviations on your site that you’d 
like to make searchable (in which case 
you should set the value to 2). 


Search wnlnj}* - 



©The Search settings page 
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5 . Leave the “Simple CJK handling” check 
box selected unless you’re incorporat¬ 
ing a non-Drupal search solution for 
Chinese, Japanese, or Korean text. 

6 . The “Active search modules” section 
lets you decide whether visitors can 
search for users, nodes, or both, and 
also lets you determine which one the 
search results page returns by default. 

7 . The “Content ranking” section lets you 
control factors that put nodes near the 
top of the search results page. You 
have control over five criteria: 

► Number of comments: Considers the 
number of comments attached to a 
node, where a larger number makes 
the node seem more important and 
therefore more worthy of appearing 
near the top. 

► Keyword relevance: Considers the 
number of times a keyword occurs 
in a node and where in the node it 
occurs. (A keyword in the title scores 
higher than one in the body, for 
example.) 

► Content is sticky at top of lists: Simply 
checks whether you’ve selected the 
“Sticky at top of lists” check box in 
the “Publishing options” of that node. 
(See the section “To make a node 


appear at the top of the page when 
grouped with other nodes” in Chap¬ 
ter 3 for details about this option.) 

► Content is promoted to the front 
page: Changes a hit’s ranking based 
on whether that node’s “Promoted to 
front page” check box is selected. 

► Recently posted: Compares posting 
dates, with the most recent nodes 
floating to the top. 

To increase a criterion’s importance, 
increase its Weight by clicking its pop¬ 
up menu. The Weight interface here is 
counter to how it appears elsewhere 
in Drupal, for example when changing 
the menu settings on a node (as was 
demonstrated in the section “To create 
a menu item that links to a node” in 
Chapter 3). In other places, items with 
smaller numbers float to the top of 
the screen. But here, larger numbers 
result in items floating to the top of the 
screen. 

GD Robert Douglass’s article “Drupal's 
search module and scoring factors” at 
lullabot.com/articles/drupals_ 
search_module_and_scoring_factors 
examines search settings in great depth 
(albeit with an old version of Drupal). 
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Directing Traffic 
with Menus 

Menus are like those slushy winter puddles 
that look shallow but swallow your leg 
up to the calf when you step off the curb. 
Behind a small set of links is a lot of intel¬ 
ligence that determines where, when, and 
how menus appear. 

Drupal’s way of building menus is one of 
the oldest parts of the software, going 
back (in one form or another) to Version 1.0. 
It has some surprisingly intuitive features— 
for example, menu links remain valid even 
after you change the paths they lead to. 

But with maturity has come complexity, so 


some explanation is necessary to under¬ 
stand them. 

In Drupal’s default configuration, two 
menus are always on your screen: The 
Main menu shows up as tabs near the 
screen’s upper left, while the User menu is 
in the upper right. These two menus also 
appear as blocks, which you can place in 
various regions around the page. 

The Navigation menu shows up as a block 
in the “Sidebar first” region by default ©. 

A fourth menu (“Management”) exists only 
as a hidden block. You can learn how to 
control the appearance of this or any other 
menu in block regions by reading the “Lay¬ 
ing Out Your Site with Blocks” section in 
this chapter. 


Main menu 


Navigation 



-c:: 


Welcome to the Sunrador enthusiasts site! 

Do you low your Mill* Sounder RV aa much aa I do? Than Ihu ii the plan far jrait. Ilare youH Sod 
company's kutory, «here to act part*, and adventure* you Ye had in your an 'radar. 


Trip report: Oberiin. Ohio to Corning, New York 

PLOMftad By tontn cn lOrt«®10 • 1336 

Well, II wu ■ rough trip but t rewarding one. We flatted out early on Saturday, the rain driving hsrd_ I’m so 
glad we got that leaky window fixed! (Thanks for rending me the Irian we needed. Bob.) 

We made pretty good time grtluig our, and decided we'd Mop in Erw and hart| out at a canto And if they hat 
parking, ow'd stay mar. Why not? We wwra on vacation! 

Hint worked on OIL: We did May over, and can neoenmend the lot lo the oorth at the casino. tl’a sale, quiet, 
and pleasant. Juit be sure do« to park too eloae to the sodium Igha -tlrey rr awfully bright! 




User menu 


© Default menu locations in the Bartik theme 
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To create a menu: 

1. Click Structure in the Toolbar and then 
click Menus to reach the Menus admin¬ 
istration page ©. 

The four rows on this page are the 
menus that come installed with Drupal. 
They are: 

► Main menu: Whose links appear 
by default as tabs in the upper-left 
corner of the screen. (You can change 
which menu appears in that area. See 
“To change which menus appear in 
the Main and User links locations.”) 

► Management: By default it contains 
only one top-level link and Adminis¬ 
tration. The Administration section 
has many subiinks, leading to all of 
Drupal’s administrative controls. Its 
contents are echoed in the Toolbar: 


Changing this menu changes the 
appearance of the Toolbar as well. 

► Navigation: Has only the “Add con¬ 
tent” link enabled by default, although 
others appear there automatically as 
you enable modules. For example, 
enabling the Forum module puts a 
Forums link there. 

► User menu: Appears, by default, in 
the upper-right corner of the Bartik 
theme. Like the Main menu, you can 
change whether this menu appears 
in that area: See “To change which 
menus appear in the Main and User 
links locations.” 

The User menu is also echoed in the 
Toolbar for those users with permission 
to see the Toolbar. 

continues on next page 


Menus ® 

■ 

LIST MENUS 

SITTINGS J 


Home » Administration > Structure 




A 

Each menu has a corresponding block that is managed on the Blxks administration page. 





♦ Add menu 





TITLE 

OPERATIONS 



Main menu 

list 

edit 

add 


The Mam menu Is used on many sites to show the major sections of the site, often In a too navigation bar. 

links 

menu 

link 


Management 

list 

edit 

add 


The MAntgrment menu contains links for administrative tasks. 

links 

menu 

link 


Navtgation 

The Mn-igartAA menu contains links intended for site visitors, links are added to the Mawpaftori menu 
automatically by some modules. 

list 

links 

edit 

menu 

add 

link 


User menu 

list 

edit 

add 


The Mter menu contains links related to the user's account, as well as the Tog out’ link. 

links 

menu 

link 





©The Menus administration page 
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2 . To add a menu, click the “Add menu” 
link. Fill out the form and click Save 
when finished Q. Drupal automatically 
creates the URL path for accessing 
this administration page, but you can 
change it by clicking its Edit link. It can 
contain only numbers, lowercase let¬ 
ters, and hyphens. (This is in contrast 
to many internal names you set up in 
Drupal, which can contain underscores 
but not hyphens.) The Title appears 
near menu links (for example, “Manage¬ 
ment”); the Description appears only in 
administrative contexts and isn’t visible 
to non-privileged visitors. 

3 . You’ve now created the menu, but it’s 
not terribly useful yet because it has no 
links. The next section shows you how 
to add them. 


Hume » Administration » Structure > Menus 


You un enable (he newly created block for this menu on the Blocks administration page. 


1 path technical help (UM) 


This nwiu eontjura uma to pngm of tips, rjirngonmo by component 



© Setting 


up a menu 
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To add menu links to a menu: 

1. There are two main places in Drupal 
where you can add links to menus: 

► When you create or edit a node. 
However, you can link only to menus 
specified by the node’s content type. 
To learn how to specify those menus, 
see “To create a new content type” 
in Chapter 4, particularly the section 
about menu settings. 

► In several places in and around the 
Menus administration page, which 
you reach by clicking Structure in the 
Toolbar and then clicking Menus. 

2 . To add menu links when editing a node, 
click the “Menu settings” tab at the bot¬ 
tom of the screen and fill out the form. 
This was described more fully in the “To 
create a menu item that links to a node” 
section in Chapter 3. 


3 . There are several ways to add menu 
links from the menu administration 
pages: 

► On the page Drupal displays when 
you’ve created a menu, click either of 
the “Add link” links ©. You can also 
reach this page by clicking the “List 
links” page next to a menu’s name on 
the Menus administration page. 

► Click “add link” next to the menu’s 
name on the Menus administration 
page shown in © 

Some downloadable modules, 
including the popular Views module 

(drupal.org/project/views), provide 
other ways to add menu links. 

continues on next page 
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4 . Drupal delivers you to the menu link 
edit form ©. Enter a Menu link title, 
which becomes clickable text leading 
to the location you choose. 

5 . Enter a Path, which can be a valid URL 
in any of the following forms: 

► An external link (for example, http:// 
www. example, com/page. html). 

► A node on the site, referred by node 
ID number (for example, node/l). 

► A node on the site, referred by 
URL path (for example, rv-parts/ 
page-of-information). 

► A non-node part of your Drupal 
site that is accessible via a static 


(non-changing) URL path, for example 
the path to a downloadable file such 

as http://domain-name/sites/ 
default/f iles/spec-sheet.pdf, 

► A location created by Drupal itself 
or by a downloaded module, for 
example user/register (which leads 
to the user registration page). 

► The front page, given simply as 

<front>. 

Don’t add a leading slash when indicat¬ 
ing URLs on your Drupal site. So if the 
URL to which you want to link a menu 
is http://domain-name/node/l, you 
would enter node/l, not /node/l. 


Technical help ® 


Home » Administration > Structure » Menus » technical help 

Menu link title * 


The text to he used for this link in the menu. 


The path for this menu link. This can be an Internal Drupal path such as node/idd or an external URL such as http://druiiil.org. 
Enter <front> to link to the front page. 


Shown when hovering over the menu link, 
g enabled 

Menu links that are not enabled Mil not be listed in any menu. 

Q Show as expanded 

If selected and this menu link has children, the menu will always appear expanded. 

Parent link 

-Technic* help:- _*J 

The maximum depth for a link and all its children Is fixed at 9. Some menu links may not be available as parents If selecting 
them would exceed this limit. 

Weight 

o 5 

Optional, in the menu, the heavier links will sink and the lighter links will be positioned nearer the top. 



© The form to add a menu link 
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Technical help 


o 

o 

o 

o 


Bathing 

Cookin g 

Coolie" 

Range, oven, and camp cooking gear 
Heating-- 1 - 


© Refrigeration 
o Sleeping 
o Water (black) 
o Water (fresh) 
© Water (gray) 


Q A menu link’s Description 
text as it appears to visitors 


6 . Enter optional Description text, which 
shows up in a floating box when visitors 
hover their pointers over the link Q. 

7 . The Enabled check box lets you quickly 
turn off a menu link so it doesn’t appear 
to any visitors. Deselecting the Enabled 
box doesn’t delete the menu link. You 
can turn it on again at any time by edit¬ 
ing the menu link and reselecting this 
check box. 

8 . The “Show as expanded” check box 
comes into play when you create multi¬ 
level (“hierarchical”) menus, as you’ll 
learn about in the section “To rearrange 
menu links.” 

9 . The “Parent link” pop-up menu gives 
you a quick way to change which menu 
a menu link is in, or to set up multi-level 
menus. You’ll see how to do that in the 
section “To rearrange menu links.” 

10 . The Weight pop-up menu lets you 
re-order this menu link among the 
others by making it “lighter” (with 
a lower value) or “heavier” (with a 
higher value) than other menu links in 
the same menu. However, you’ll see 

a much easier way to do so in the sec¬ 
tion “To rearrange menu links.” 

11 . When you’ve finished creating the 
menu link, click Save. 


GD When you create a menu link to a node, 
that link shows up in the node’s edit form in 
the “Menu settings” tab. Multiple menu links 
can lead to the same node, but that tab shows 
only the first link created. If you delete that 
link, the second one created appears in that 
tab. You can always edit all menu links through 
the Menus administration interface. 
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To delete a menu link: 

There are several ways to delete a menu 
link. Do any of the following: 

■ Go to the Menus administration page 
by clicking Structure in the Toolbar and 
then clicking Menus. Click “list links.” 

On the resulting page, click “delete” 
next to the appropriate link. 

■ While on a menu link’s edit page, click 
the Delete button at the bottom of the 
form. 

■ While on a node’s edit page, deselect 
the “Provide a menu link” check box, 
then click Save at the bottom of the 
form. If multiple menu links lead to this 
node, only the first one will be deleted. 

These techniques work only on menu links 
you explicitly created, not on those created 
by a module or Drupal itself. 

To delete a menu: 

1. Go to the Menus administration page 
by clicking Structure in the Toolbar and 
then clicking Menus. 

2. Click the “edit menu” link next to the 
menu you want to delete. 

3. On the resulting page, click the Delete 
button. You’ll see a warning screen that 
informs you of how many menu links 
you’ll destroy by deleting this menu. To 
confirm your choice, click Delete. 

Deleting a menu removes all menu links 
it contains, but it does not affect the 
locations those links led to. Don’t worry: 
You’re not deleting any nodes, only the 
links that lead to them. 

GD You can’t delete any of Drupal’s core 
menus: Main menu, Management, Navigation, 
and User menu. (These menus don’t have a 
Delete button on their “edit menu” pages.) 
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0 The “List links" page for a menu named 
“Technical help” 


To rearrange menu links: 

1. Click Structure in the Toolbar and then 
click Menus to go to the Menus admin¬ 
istration page. 

2. Click “list links” next to the menu whose 
links you want to rearrange. 

3. On the resulting page, you can perform 
several tasks in addition to rearranging 
menu links © 

► Clicking the link in the “Menu link” 
column takes you to the linked-to 
page. 

► The check box in the Enabled column 
determines whether a menu link is 
visible to visitors. 

► The Operations column contains links 
to edit or delete the specified menu 
link. 

4. To change the position of a menu item, 
click and drag its + icon, much as you 
saw in the section “To change a book’s 
structure” in Chapter 3. 

Click “Save configuration” after 
reordering menu items. If you navigate 
away from the page before saving your 
changes, Drupal will discard the new 
menu link order. 


Improving Access to Content 135 





To rearrange menu links 
into a hierarchy: 

1. You can also make some menu items 
“parents” of others, creating a hier¬ 
archical menu. There’s one good 
opportunity in 0 The three menu links 
that start with “Water” would do well 
grouped under a parent link. Here’s 
how we’ll do that. 

2. Create a new menu item by clicking 
“Add link” and filling out the link cre¬ 
ation form. In our example, we’ll give 
it the title “Water.” 

3. Drag each of the three targeted links so 
they’re subordinate to the one we just 
created © (It might take some mous¬ 
ing practice to drag them into the right 
place.) Click “Save configuration.” 

4. Click “edit” next to the newly created 
Water link. On the resulting page, 
enable the “Show as expanded” check 
box. (We could also have enabled this 
check box on the link’s edit form when 
we created it.) 

5. Click Save. The “Technical help” menu 
now has the structure you see in O- 
Note, however, that you haven’t actu¬ 
ally made it visible to visitors yet: You’ll 
learn how to do that in the section “Lay¬ 
ing Out Your Site with Blocks.” 


+ Watt* 

0 

edit 

delete 

Wiw <black) 

0 

edit 

delete 

+ Wit*. (tr.ih) 

0 

edit 

delete 

+ Wit*. (grey) 

0 

edit 

delete 

Save configuration 


Q Our menu after making three links the 
“children” of the Water link 


Technical help 

o Bathing 
o Cooking 
o Cooling 
<j Heating 
o Refrigeration 
o Sleeping 
▼ Water 

o Water (black) 
o Water (fresh) 
o Water (gray) 


O The menu after 
selecting “Show as 
expanded" next to 
the Water link and 
making three links 
subordinate to it 
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GD Drupal requires every item in a menu 
to link to a URL. That’s unfortunate, for a 
reason that’s obvious in ©: Where should the 
Water link go to? You could link it to a simple 
page that lists its children’s menu links, for 
example, or have it go to the same page as the 
first child link. Neither solution is very good; 
better ones are possible through custom PHP 
programming. 

(ZD Menu appearances vary widely depend¬ 
ing on your theme and the block region in 
which you’ve placed the menu. For example, 
hierarchical links placed in the Main menu 
of the Acquia Marina theme (drupal.org/ 
project/acquia_marina) automatically 
expand as a pop-up menu. That is, hovering 
your mouse over our Water menu would reveal 
the other three choices. 

OD Menu hierarchies can be up to nine lev¬ 
els deep, but I recommend you make them no 
more than three levels deep. 

GD An alternative way to make one menu 
link the child of another is to click its “edit” 
link and then select the desired parent item 
in the “Parent link” pop-up menu. Then click 
Save as usual. 


To change menu titles: 

1. Visit the Menus administration page by 
clicking Structure in the Toolbar and 
then clicking Menus. 

2. Except for four menus that are part of 
Drupal’s core—Main menu, Manage¬ 
ment, Navigation, User menu—you 
can change the title of any menu. To 
do so, click the “edit menu” link that 
corresponds to the menu you want to 
change. 

3. On the resulting page, type the menu’s 
new name into the Title field. 

4. Click Save at the bottom of the form. 
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To change which menus appear in 
the Main and User links locations: 

1. You can place any menu into any block 
region on the page, as you’ll learn in 
the section “Laying Out Your Site with 
Blocks.” But many Drupal themes also 
have two special areas called “Main 
links” and “Secondary links.” 

By default, Drupal puts the Main menu 
in the Main links area and puts the User 
menu in the Secondary links area. But 
you can change which menus appear in 
those areas. To do so, go to the menu 
settings page by clicking Structure in 
the Toolbar and then clicking Menus. 
Then click the Settings tab O- 

2. On the resulting page, select your 
preferred menus on the “Source for the 
Main links” and “Source for the Second¬ 
ary links” pop-up menus. Then click 
“Save configuration.” 


GD In some themes, if you set the “Source 
for the Main links” and “Source for the Sec¬ 
ondary links” pop-up menus to refer to the 
same Drupal menu, the Secondary links area 
will change depending on what’s selected 
in the Main links area. To take our example: 

If both pop-up menus were set to “Techni¬ 
cal help,” and you clicked Water in the Main 
links area, the Secondary links area would list 
Water (black). Water (fresh), and Water (gray). 
(Unfortunately, this feature doesn’t work with 
the default Bartik theme.) 

GD You might remember that each menu 
comes with a block that you can place in block 
regions. Putting a menu into the Main links or 
Secondary links area doesn’t use up its block: 
You can make that menu appear in another 
part of the page by moving its block there. 
(See “Laying Out Your Site with Blocks” to 
learn how.) 



O The menu settings page, where you can determine which menus appear in the Main 
and Secondary link areas 
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TOGGLE DISPLAY 

Enable or disable the display of certain page elements, 
a Logo 

Wj Site name 

@5 Sitp slogan 

M User pictures in posts 

^ user pictures in comments 

^ User verification status in comments 

M Shortcut icon 

□ Main menu 

(^Secondary menu 


O Turning off the Main and Secondary menus 
by deselecting their check boxes on the theme 
settings page 


Management I Sunradrr 


A £ 

««ad.. f an. 


tittp /;iix4lhovi/*ovtflav-admifi/Mmttu«t/ 1 » 


App«aran<* P»oc*« Module! CenAfurntoa »*com 



O The Toolbar echoes the Administration section 
of the Management menu 


To disable the Main, Secondary, 
and Toolbar menu areas: 

1. There are two ways to hide the Main 
and Secondary links areas. Either: 

► Go to the menu settings page as 
described in the section “To change 
which menus appear in the Main and 
User links locations.” Select “No main 
links” from the “Source for the Main 
links” pop-up menu, or “No second¬ 
ary links” from the “Source for the 
Secondary links” pop-up menu, or 
both. Click “Save configuration.” 

or 

► Go to the theme’s settings page by 
clicking Appearance in the Toolbar 
and then clicking Settings next to the 
current theme. In the “Toggle display” 
section, deselect the “Main menu” or 
“Secondary menu” check boxes, or 
both © Click “Save configuration.” 

2. The Toolbar is the black area at the top 
of every screen that, by default, dis¬ 
plays top-level links from the Adminis¬ 
tration part of the Management menu to 
everyone with permission to see it O- 

To turn it off, go to the Modules adminis¬ 
tration page by clicking Modules in the 
Toolbar. Then, deselect the check box 
for the Toolbar module and click “Save 
configuration.” 

GD You can change what appears in the 
Toolbar by monkeying with the Administration 
section of the Management menu, it’s true. But 
I prefer to leave that as it is and customize the 
Shortcut bar instead; that’s what it’s designed 
for, so changes are much easier to make. To 
learn how, see “To change which items appear 
in the Shortcut bar” in Chapter 2. 
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Laying Out Your 
Site with Blocks 

Drupal’s restrictions frustrate many tra¬ 
ditional web designers who are used to 
working in pure HTML, which lets them put 
whatever they want anywhere on the page. 

Why can’t Drupal do that? 

The fact is, Drupal can do that—if man¬ 
aged by someone with enough knowledge 
of PHP and CSS. But that’s a feature, 
not a bug. By forcing designers to work 
within a well-defined structure, Drupal 
(usually) prevents bad design decisions 
from obscuring content and navigation. 

As Marge Simpson said, “One person can 
change the world, but most of the time 
you probably shouldn’t.” 

Somewhere between fill-in-the-blank 
inflexibility and HTML’s Wild West approach 
to page structure, Drupal offers a com¬ 
promise in a system of content containers 
called blocks. Drupal includes some blocks 
to start with, automatically makes others 
when you do certain actions (such as creat¬ 
ing menus), and lets you create further 
blocks explicitly. You place blocks in block 
regions that are defined by the theme. 

(Drupal’s default theme—Bartik—has 15 
block regions.) Q The g^^g administration page, which lists 

This section will show you how to create blocks and the block re 9 ions that contain them 

blocks, move them around, restrict their 
visibility to specified groups of users, and 
make them show up only on certain pages. 

Blocks might not offer HTML’s flexible lay¬ 
out options, but they do provide features 
that ultimately enhance content access in 
ways that aren’t possible with plain HTML. 
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© The block region demonstration page, which 
graphically shows where block regions appear on 
the page for a specific theme 


To move blocks among 
and within regions: 

1. Click Structure in the Toolbar and then 
click Blocks to reach the Blocks admin¬ 
istration page, which lists available 
blocks and the block regions into which 
you can place them ©. 

Here we see the Bartik theme’s Blocks 
administration page with one small 
addition to its default state. When we 
built the “Technical help” menu earlier 
in this chapter (in the “Directing Traf¬ 
fic with Menus” section), Drupal auto¬ 
matically created a block for it, but put 
that block in the “Disabled” group so 
it doesn’t show up anywhere on the 
page. We’re going to move that block 
into the“Sidebar first” area, which in this 
theme is the left column. 

To get a visual representation of where 
block regions are on a page, click the 
“Demonstrate block regions” link ©. 

To return to the Blocks administra¬ 
tion page, click “Exit block region 
demonstration.” 

continues on next page 
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2. There are two ways to move a block 
into a block region. Either: 

► Click and drag its 4* icon, as you saw 
in the section “To change a book’s 
structure” in Chapter 3. 

or 

► Select a block region from the pop-up 
menu next to the block’s name Q. 

In either case, the block will move to its 
new region and an orange asterisk will 
appear next to the menu, showing that 
you’ve changed its location. 

3. After moving a block into its region, you 
might want to change its position within 
that region. To do so, click and drag 

its 4- icon. 

4. Click “Save blocks.” If you click another 
link on this page before doing so, you’ll 
lose all the block positioning changes 
you just made. 


Disabled 

Main menu 

•J* Recent comment* 

4- Recent content 
+ Shortcuts 
4* Syndicate 
■i- Technical help 

Q Moving the “Technical help” 
“Sidebar first” region 


im Some block regions grow and shrink 
depending on whether there’s content in the 
block regions adjoining them. The shape- 
shifting behavior of such “flexible” blocks 
usually makes your site look better, but it can 
be a surprise if you’re not expecting it. As 
with most interface changes, the solution is to 
browse the site thoroughly before publishing 
to ensure that it looks the way you want—or, at 
least, that the shifting of flexible block regions 
doesn’t destroy your design. 


(ID Block styles often vary depending on 
which region the block is in, especially in 
the Header and Footer regions. (Yet another 
reason to double-check your design before 
publishing!) 



Triptych first 
liptych m«J®o 
triptych Ittt 
Footer fret column 
Forte second column 
Footer tfwd column 
Footer fourth cofcjmn 

Foote- _ 

NOM - 


block to the 
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O The configuration page for a specific block 


To configure where and 
how a block appears: 

1. Go to the Blocks administration page 
by clicking Structure in the Toolbar and 
then clicking Blocks. Click the “config¬ 
ure” link next to the block you want to 
change. 

The resulting configuration page may 
vary somewhat, depending on the 
type of block you’re configuring. Those 
created by Drupal modules may have 
additional (or fewer) controls. We’ll look 
at the configuration page for the block 
that appeared when we created the 
“Technical help” menu, which is fairly 
typical ©. 

2. This block configuration page is broken 
up into six sets of controls, the first one 
being “Block title.” If you leave this field 
empty, the block will usually display 
with the block name as its title—in this 
case, “Technical help.” (Whether the 
block title appears at all depends on 
the theme and the region in which you 
place the block.) To change the block 
title that visitors see, enter it in this field, 
or hide the title entirely by entering 
<none>. Note that this doesn’t change 
the name of the block, which you see in 
the administrative interface. 

3. The next section lets you specify where 
this block should appear in enabled 
themes. (To learn how to enable a 
theme, see the section “Selecting a 
Visual Theme” in Chapter 2.) These 
pop-up menus serve the same function 
as those on the Blocks administration 
page you saw in the section “To move 
blocks among and within regions.” 

continues on next page 
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4. At the bottom of the page are four tabs 
for Visibility settings. The one shown 
by default, Pages, lets you determine 
on which page (or pages) this block 
displays. You have a choice of list¬ 
ing pages where the block should or 
shouldn’t display. If you’ve enabled the 
PHP text format (as described in Chap¬ 
ter 5, “Making Content Interactive”), you 
can also specify pages for block display 
with a PHP program. 

5. Clicking the “Content types” tab 
presents controls that let you show the 
block only on pages containing nodes 
of specific content types. (For more 
information about content types, see 
Chapter 4, “Customizing Content.”) Dru- 
pal automatically displays one check 
box for each content type in your site, 
and leaving them all unselected means 
that the block will appear with nodes of 
all content types ©. 

6. Clicking the Roles tab lets you define 
which groups of users can see the 
block. Each role in your Drupal site has 
its own check box. Select the users that 
you want to be able to see the block Q. 
(For more information about user roles, 
see Chapter 7.) 

If you leave all check boxes unselected, 
the block will be visible to all users. 
Further, these selections have no inheri¬ 
tance. That is, making the block visible 
to anonymous users doesn’t automati¬ 
cally make it visible to administrators, 
even though administrators usually 
have more permissions than anony¬ 
mous users. 



© Options for displaying the block on pages 
containing nodes of specific content types 



Q Options for displaying the block to selected 
roles 
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0 Changing a block’s settings so that 
authenticated users can choose to turn it off 



0 The control on an individual user’s page to hide 
or display the “Technical help” block 



O Creating a new block with simple HTML tags in 
the body 


7. Finally, the Users tab lets you give 
users the option of displaying or hiding 
this block wherever it appears 0 This 
choice is only available to registered 
(“authenticated”) users: They make that 
selection by going to their user page at 
http://do/wcjif7-name/user and clicking 
the Edit link, then selecting (or deselect¬ 
ing) the block’s check box 0 

8 . When you’ve made all the desired 
configuration changes to a block, click 
“Save block.” 

To add a block: 

1. Go to the Blocks administration page 
by clicking Structure in the Toolbar and 
then clicking Blocks. Click the “Add 
block” link. 

2. The resulting page looks almost exactly 
like the one you saw in the section 

“To configure where and how a block 
appears,” except the top area pro¬ 
vides you two additional fields: “Block 
description” (which appears on the 
Blocks administration page) and “Block 
body” ©. 

The “Block body” field actually holds 
the contents of the block. Earlier in 
this chapter, we were working with a 
block that contained a menu’s links; 
but blocks that you create using the 
“Add block” tab can contain anything 
you want. The “Block body” field is just 
like a node’s Body field, where you can 
enter plain text, HTML, or any other text 
format available on your Drupal site. 
(See Chapter 5 for more information 
about text formats.) 

3. When you’re finished, click “Save 
block.” 
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The Future of Drupal Layout 

While Drupal’s block system has served well for many years and continues to be the chief light¬ 
weight method to define layout, alternatives (in the form of contributed modules) are starting to 
emerge. 

One of the most promising is Panels (drupal.org/project/panels), which essentially lets you 
create block-like layout sections and place them in juxtaposition anywhere on the page. Besides 
being more flexible graphically, Panels can also handle a much wider range of content than blocks 
can, including various kinds of changing (dynamic) content. Its complex abilities come with a com¬ 
plex interface, though, so you need a fairly good grasp of Drupal concepts to use it. 

Another module that’s attracted attention recently is Skinr, available at drupal.org/ 
project/skinr. It lets Drupal themers expose controls for their Cascading Style Sheets (CSS) 
through Drupal’s interface so that administrators can apply them much more easily and flex¬ 
ibly. The module’s gotten a big boost from the popular theming company TopNotchThemes 
(topnotchthemes.com), which has made Skinr an essential part of its new Fusion theming 
system (fusiondrupalthemes.com). 

As this book goes to press, neither of these modules has been released yet in final form for 
Drupal 7. But we believe (and hope!) that both will be soon. 
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Wrangling Users 


The Internet’s history proves the old adage 
“Anything that can be used will be abused.” 
Post an email address online and spam 
attempts begin within hours; launch a web 
site that permits user comments and every 
manner of stupidity will find you. 

Fortunately, Drupal has included anti-abuse 
technologies since its beginnings. Chief 
among them is its system of user roles and 
permissions, which gives you broad power 
to regulate who can perform specific 
actions on your site while keeping those 
rules manageable, even as the site grows 
to thousands of members. 

But user management is as much about 
enabling communication as preventing 
abuse. In this regard, Drupal has ways to 
let users define their online personalities 
(through profiles) and talk directly to one 
another (through contact forms). Further, 
you have a lot of ways to control and guide 
the user registration process, to both 
encourage participation and guard against 
unwanted behavior. 


In This Chapter 

Managing User Accounts 148 

Controlling Flow Users Interact with 
Their Accounts 156 

Defining User Roles and Permissions 163 

Building and Protecting Your User 
Community 171 




Managing User 
Accounts 

As your site’s administrator, you can add 
users, change their personal information, 
and prevent them from accessing the site. 
You can also display a list of all users who 
have certain permissions or roles, and per¬ 
form certain actions on the found set. 

In a perfect world, you’d never have to 
deal with user accounts: Users would fill 
out their registration forms correctly, man¬ 
age their own accounts, and never attempt 
to do anything they shouldn’t. But the real 
world doesn’t work like that, of course. You 
might meet someone in the street who 
wants to join your site, for example: Drupal 
lets you create the account yourself, then 
sends the new member a user name and 
password. In addition, you can decide what 
happens to user accounts when someone 
decides to leave your site, and you can 
choose to keep or delete the content they 
created. 

To create a user account: 

1. Click People in the Toolbar to go to the 
People administration page ©. 

2. Click the “Add user” link to go to the 
new user creation form ©. 

3. Complete the “Add user” form. 

► Username: Required, must be unique, 
and may contain only letters, num¬ 
bers, and those characters speci¬ 
fied in the help text below the field. 
(The ability to include apostrophes 
in user names is new in Drupal 7.) 

User names are not case sensitive: If 
there’s a user named Joseph, Drupal 
won’t let you create another user 
named joseph. (That user will be able 
to log in as either Joseph or joseph.) 



© The People administration page 



© The form for adding a user to your Drupal site 
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► E-Mail address: Also required and 
must be unique. Drupal uses this 
email address in several ways, so an 
invalid or incorrect address can cause 
quite a few problems, especially if the 
user is also an administrator. Further, 
Drupal doesn’t include any features 
to manage bouncing email, so you 
might never find out that an email 
address is wrong. Double-check that 
address! 

► Password: Required. You can use 
any password that contains letters, 
numbers, or punctuation; spaces are 
also fine, but the password can’t be 
composed of only spaces! As you 
enter the password, Drupal provides 
suggestions for making the password 
stronger —that is, harder to guess. As 
you follow its suggestions, the bar 
next to Password strength grows 
longer, as encouragement to create a 
more secure password. 

The “Confirm password” field helps 
prevent password typos by forcing 
you to type the same password again. 
As long as the second password field 
differs from the first, the word next 
to “Passwords match” shows as “no.” 
When the two fields match, the word 
changes to “yes” ©. 


► Status: Radio buttons indicating 
whether the user will be able to log 
in and use the account. Leave the 
Active button selected unless you 
want to create the account now but 
make it unavailable until later. 

► Roles section: Contains check boxes 
for each role available for registered 
users on your Drupal site. By default, 
there are only two: “authenticated 
user,” which is always true for reg¬ 
istered users, and “administrator.” 
(There is technically one other role on 
your Drupal site, “anonymous user,” 
but by definition nobody with a user 
name can have that role, so it’s not an 
option here.) 

If you’ve added any other roles (as 
you’ll learn how to do in the “Defining 
User Roles and Permissions” section), 
they’ll also appear as options here. 

► The last field is the “Notify user of 
new account” check box. If selected, 
an email will go to the address pro¬ 
vided earlier in the “E-mail address” 
field on the form. You’ll learn how to 
change the contents of this email in 
the section “To modify automated 
administration emails and determine 
when to send them.” 

continues on next page 


Password * 

..... Password strength; Weak 


Confirm pdssword * 

••• Passwords match: no 


To make vour password stronqer: 

• Make it at least 6 characters 

• Add uppercase letters 

• Add numbers 

| « Add punctuation _ 

Provide a password for the new account in both fields. 


Q Drupal’s feedback to improve a password’s strength and 
ensure it’s been entered correctly 
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4. When you’ve completed the form, 
click “Create new account.” Drupal 
creates the account and sends the 
user-notification message (if you 
selected the “Notify user of new 
account” box in step 3), and you’re 
taken back to a blank user-creation 


form so you can create multiple new 
users in quick succession. 

You don’t need to create any other 
users unless you want to, of course. To 
escape the process at any time, close 
or navigate away from the “Add user” 
window. 


I'm a Person, Not a User! 

You might have noticed the words users and people used interchangeably in this chapter. The 
traditional term is user— that’s what you’ll find in Drupal 6, in all previous versions, and in the com¬ 
puter industry in general. But discussions within the Drupal community led to the use of people for 
two main reasons: 

■ Not everybody who interacts with a Drupal-based site is, strictly speaking, a user of it. For 
example, a site could contain a list of people who plan to attend a real-world event, although 
those people might never visit the web site themselves. 

■ Some commentators felt that people would help make Drupal 7 seem friendlier, particularly to 
inexperienced administrators. 

But the transition to people isn’t absolutely clear in Drupal 7. The URL for the administration page 
is http://rfo/noin-nome/admin/people and the text at the top is “People,” yet there’s a link that 
reads “Add user,” and the URL for your own membership page is http://domain-name/usez. 
That’s technically consistent with the idea that a user is someone with an account on a site, while 
a person might not have such an account. But that’s a quibble: For our purposes, the two words 
have an identical meaning in Drupal. 

In this book, I use the following terms: 

■ User or authenticated user: Someone with an account on your site. 

■ Visitor: Someone who is visiting your site but doesn’t have administrative privileges. Visitors 
can be anonymous users (who haven’t logged into an account on your site) or authenticated 
users (who have). 

■ Administrator: Someone with privileges to perform the action being discussed. 

I use the word people when referring to that text on Drupal’s interface: Clicking People in the Tool¬ 
bar leads to a page that says “People” at the top of it, so it’s the “People administration page.” But 
I can’t bring myself to use it in descriptions, such as “the People-creation process.” (I’m somewhat 
familiar with that process, and this ain’t it.) 

For insight, see drupal.org/node/538526. 
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To view a list of user accounts: 



O The list of people on a Drupal site 




MEMBER FOR ^ 

LAST ACCESS 


3 days 21 t sort by Member for , 7 sec ag0 
3 min 37 sec 3 min 37 sec ago 

3 min 22 sec 3 min 22 sec ago 


© Sorting the user list, with help text 
displayed when you hover your pointer 
over a sorting option 



Q The list of users, already filtered to show only 
administrators, with the imminent application of 
another filter 


1. Click People in the Toolbar to reach the 
People administration page ©. 

2. The People screen lists the 50 users 
who joined most recently, sorted from 
newest to oldest. If your site has more 
than 50 users, links at the bottom of the 
screen lead to other screens of up to 
50 users each. 

To reverse the sort order so the oldest 
registrations float to the top of the list, 
click the “Member for” header. To sort 
by Last Access, Status, or Username, 
click the corresponding header ©. 

3. In the “Show only users where” section, 
you can filter the user list by any combi¬ 
nation of three criteria, so you see only 
a subset of the complete list. 

► Role filter: Lets you show only users 
who have been granted a certain 
collection of site-access permissions. 
(For details about user roles, see the 
section “Defining User Roles and 
Permissions” in this chapter.) 

► Permission filter: Lets you show users 
who have permission to perform a 
specific action. 

► Status filter: Shows users who are 
either Active (permitted to log into 
their accounts) or Blocked. 

To specify criteria, select options from 
the pop-up menus and then click Filter. 

After you’ve filtered by at least one 
criterion, three buttons take the place of 
the Filter button Q. To change or add 
criteria, indicate them as before and 
then click Refine. Filters are additive, so 
you’ll see only users who meet all the 
specified criteria. To remove the most 
recent criterion, click Undo; to remove 
all criteria and return to showing the 
entire list of users, click Reset. 
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To modify an individual 
user's account: 

1. Click People in the Toolbar to reach the 
People administration page. 

2. To modify a single user’s account, 
either: 

► Click the “edit” link at the end of that 
user’s row. 

or 

► Click the user’s name to view that 
person’s profile and then click the 
Edit tab. 

The resulting page is very similar to the 
one you saw in the section “To create 
a user account.” (It’s also very much 
like what logged-in users see when 
they edit their accounts by going to 
http://domain-name/usei and clicking 
the Edit tab.) 


3. Here you can control the same aspects 
of the user’s account as when you cre¬ 
ated it, with a few additional options at 
the bottom of the screen 0 : 

► Picture section: Lets you associate 
this user with a graphical representa¬ 
tion, commonly known as an avatar. 
This field is only available if you’ve 
selected the “Enable user pictures” 
option. It’s enabled by default, but if 
for some reason it becomes disabled 
you can learn how to enable it again 
in the section “To allow (or forbid) 
user signatures and avatars.” 

To upload a graphic, click the Browse 
button and navigate to the file 
through your computer’s file-selection 
dialog box. Drupal will upload the 
graphic when you click Save at the 
bottom of the screen. 



0 Account-editing options that weren’t available when you 
created the account 
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► Administrative overlay section: Lets 
you decide whether the overlay 
will appear when the user performs 
administrative tasks. (This option is 
available only for users with admin¬ 
istrative privileges.) For more about 
the overlay, see the section “Using 
the New Administrative Interfaces in 
Drupal 7” in Chapter 2, “Establishing 
Your Drupal Site.” 

► Locale settings section: Lets you 
change the user’s apparent time 
zone, which affects the display of 
time-related information, such as 
timestamps for posts and comments. 

Other sections on this page may appear 
as you configure your site and add new 
modules. 

4. When you’ve finished making changes 
to the account, click Save. 
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To cancel an individual 
user's account: 

1. Go to the form to edit the user’s page, 
as the section “To modify an individual 
user’s account” described. 

2. Click “Cancel account” at the bottom of 
the form. 

3. The “When cancelling the account” 
confirmation page appears, providing 
a way to determine what to do with 
content that the user created, such 
as nodes, comments, and blog and 
forum posts © Note that these options 
embed a subtle difference between 
whether to disable or delete a canceled 
account. The four options are: 

► Disable the account and keep all 
content: The user’s account status 
changes to Blocked, and all content 
remains as before. 

► Disable the account and unpublish 
all content: The user’s account status 
changes to Blocked. All content is 


hidden from view, but it is still acces¬ 
sible to administrators on the Content 
administration page. (For more infor¬ 
mation see Chapter 3, “Creating and 
Managing Content.”) 

► Delete the account and make all 
content belong to the Anonymous 
user: The user’s account is perma¬ 
nently removed from the system and 
no longer shows up on the People 
administration page. All nodes that 
the user created are now attributed 
to “Anonymous”—that is, a person 
who didn’t log in to your Drupal site 
before creating the content. Com¬ 
ments by that person keep the same 
author name, but with the annotation 
“(not verified)” as if the commenter 
provided the user’s name without log¬ 
ging in. 

► Delete the account and all content: 
Both the user’s account and all con¬ 
tent attributed to it disappear. 


Are you sure you want to cancel the account Sylvia Altschuler ? 


Homo » Sylvia Altschutar 

When cancelling the account 
0 Disable the account and keep all content. 

O Disable the account and unpublish all content. 

0 Delete the account and make all content helong to the dnort/moiM user. 

O Delete the account and all content. 

Q Require e-mail confirmation to cancel account. 

When enabled, the inter mint confirm the account cancellation via e-mail. 

Select the method to cancel the account above. This action cannot be undone. 


Cancel account 


© The account-deletion page with options regarding user status, 
notification, and content 
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You can change which radio button 
is selected by default on the Account 
settings page. For more information, 
see the section “To change Drupal’s 
behavior for account creation and 
cancelation.” 

4. The “Require e-mail confirmation to can¬ 
cel account” check box lets you give the 
user the final choice on whether to can¬ 
cel the account. When you select this 
option and then click “Cancel account,” 
Drupal sends an email message to the 
address associated with the account. 
That message contains a secure link: If 
the user clicks it within 24 hours, Drupal 
completes the action of disabling or 
deleting the account. Otherwise, the 
account remains as it was. 

When you’ve made your choices, click 
“Cancel account.” To leave the account 
as it was, click Cancel. 


Deleting an Account: How Hard Could It Be? 

This one account-deletion page looks simple: just a few radio buttons and a check box. But it’s 
made more complicated when you allow users to cancel their own accounts, as Drupal 7 does for 
the first time. Figuring out what should happen to such accounts—and the content created in their 
names—has the distinction of being Drupal’s longest-running puzzle. Discussion about it started 
in 2001 as the eighth node (drupal.org/node/8) created on the Drupal project’s official web 
site, which now contains nearly a million nodes. (Drupal 7 maintainer Angie Byron tells the story 
of the hero who took charge and worked it ail out at webchick.net/contributor-spotlight/ 
daniel-kudwien.) 

Node 8 is a good example of the saying “easy is hard”—and a sign of just how much goes on 
behind the scenes to make Drupal work well. Both Drupal and its thousands of contributed mod¬ 
ules have “issue queues” full of difficult problems like Node 8, and thousands of developers (and 
others) volunteer countless hours every year to fix them. So whenever you come across something 
in Drupal that doesn’t work right, remember the many things that do —and show Drupal’s maintain- 
ers some love. 
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Controlling How 
Users Interact with 
Their Accounts 

With Drupal’s account settings at their most 
liberal, anyone who can find your site can 
create an account on it, thereby gaining 
permission to post comments, create a 
user profile, and do anything else you 
allow authenticated users to do. That’s 
good in terms of accessibility: Your site’s 
user population can grow large without 
your intervention. But on the down side, 
spammers and other online vandals have 
developed tools that automatically sign 
up for accounts on Drupal sites to place 
advertisements, contact users, and other¬ 
wise wreak havoc. 

Fortunately, it’s easy to change Drupal’s 
default user-registration behavior to let you 
decide on a case-by-case basis whether to 
allow users to join your site. Your control 
of signup behavior goes well beyond that, 
though. You can also allow (or forbid) sig¬ 
natures and user graphics, choose whether 
users need to confirm their email addresses 
before being allowed in, and change the 
messages they get when they join. 


To change Drupal's behavior for 
account creation and cancelation: 

1. Click Configuration in the Toolbar and 
then click “Account settings.” 

2. Scroll down to the “Registration and 
cancellation” section. Select your pre¬ 
ferred option in the “Who can register 
accounts?” field, which contains three 
radio buttons ©: 

► Administrators only: Means that users 
can neither register themselves 

nor request a user account through 
Drupal. The “Create new account” 
link disappears from the User login 
block that appears in the left column 
in most themes (including Drupal’s 
default theme, Bartik). Visitors who 
try to reach the “Create new account” 
page directly at http -.//domain-name/ 
user/register get an “Access 
denied” message. 

► Visitors: Means that anybody can get 
an account without any intervention 
by an administrator. 

With this option set, and assum¬ 
ing you’ve left the “Require e-mail 
verification” check box (described 
below) selected, a user who clicks 


REGISTRATION AND CANCELLATION 

Who can register accounts? 

O Administrators only 
O Visitors 

0 Visitors, but administrator approval is required 

Require e-mail verification when a visitor creates an account. 

New users will be required to validate their e mail address prior to logging into the site, and will be 
assigned a system generated password. With this setting disabled, users will be logged in immediately 
upon registering, and may select their own passwords during registration. 


© Options to decide how much control you have over the creation 
of new accounts 
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the “Create new account” link and 
submits the form sees a message 
on the resulting screen that reads, 
“Your password and further instruc¬ 
tions have been sent to your e-mail 
address.” 

► Visitors, but administrator approval 
is required: Means that visitors can 
set up an account, but its status will 
remain as Blocked until someone 
with “Administer users” permission 
approves it. (To understand how 
to grant that permission, see the 
section “Defining User Roles and 
Permissions.”) This is Drupal’s default 
setting. 

With this option set, a user who 
clicks the “Create new account” link 
and submits the form sees a mes¬ 
sage on the resulting screen that 
reads, “Thank you for applying for 
an account. Your account is currently 
pending approval by the site admin¬ 
istrator. In the meantime, a welcome 
message with further instructions has 
been sent to your e-mail address.” 

Drupal also sends an email message 

to the superuser that reads, “username 


has applied for an account,” along with 
a link to the page where that adminis¬ 
trator can approve the application. 

3. To require users to confirm their email 
addresses before their accounts 
become active, leave the “Require 
e-mail verification when a visitor creates 
an account” check box selected. 

In this case, the user does not have the 
opportunity to set a password when 
joining the site; instead, Drupal sends 
a temporary password to the email 
address the user provided. (To learn 
how to change the text of that email, 
see the section “To modify automated 
administration emails and determine 
when to send them.”) 

If the address was a fake (as is common 
in accounts created for abusive pur¬ 
poses), the user will never receive the 
password and will therefore never be 
able to log in to your site. 

If you decide to deselect the check box, 
Drupal will require the user to choose 
a password when creating the account, 
and no email confirmation will occur. 

continues on next page 
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4. The next section on the page, “When 
cancelling a user account,” provides 
four options ©• 

The selection you make here becomes 
the default, but you can change it when 
you actually delete an account. For 
details on the differences among the 
four settings, see the section “To cancel 
an individual user’s account.” 


When cancelling a user account 
© Diuhle the account and keep all content. 

O Disable the account and unpubllsh all content. 

O Delete the account and make all content belong to the Anonymous user. 

O Delete the account and all content. 

users with the Select method for cancelling account or Administer users permissions can override this 
default method. 


© Setting Drupal’s default option when canceling an account 


Should I Require Email Verification? 

The history of email verification is a long and contentious one. On one hand, you protect yourself 
from spam accusations and get a better quality of user when you require it; on the other, some 
users will misunderstand the confirmation message and therefore fail to confirm their member¬ 
ships. (Online marketers claim the confirmation failure rate to be as high as 70 percent.) 

So should you require email verification? in a word: absolutely. Drupal’s popularity means that 
there are already online robots that know Drupal’s sign-up procedure well enough to take advan¬ 
tage of any site that doesn’t use email confirmation. (One obscure site I ran got a dozen such 
attempts per week.) In addition, people could sign up others without their consent: If you don’t 
require email confirmation, and you later send email to your site’s members, you could expose 
yourself to legal liability by spamming unwilling recipients. 

Fortunately, there’s one simple thing you can do to improve the email confirmation rate: Customize 
the confirmation email, following instructions in the section “To modify automated administration 
emails and determine when to send them.” Include some information about the site that will tickle 
their memories more than just the site’s name does. Shorten the message, and highlight the need 
for confirmation. (The default messages are somewhat weak on these points.) 

Finally, go through your list of users at http://do/nain-name/admin/user once in a while to make 
sure that none slipped through the cracks. You might even consider sending a message to those 
who joined a while ago but are still listed as Blocked, to find out whether they did, indeed, mean to 
become members of your site. 
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To allow (or forbid) user 
signatures and avatars: 

1. Click Configuration in the Toolbar and 
then click “Account settings.” 

2 . Scroll down to the Personalization sec¬ 
tion 0. The first check box, which is 
deselected by default, lets you permit 
users to create text signatures that 
Drupal appends to every comment that 
user posts. 


3 . To allow users to upload pictures to 
represent themselves (avatars) in com¬ 
ments and user posts, ensure that the 
“Enable user pictures” check box is 
selected (as it is by default). 

However, these avatars appear on your 
site only if you’ve selected the “User 
pictures in posts” or “User pictures 
in comments” check boxes on your 
theme’s settings page. For more infor¬ 
mation about changing theme settings, 
see Chapter 2. 

continues on next page 


PERSONALIZATION 
□ Enable signatures. 

0 Enable user pictures. 

Picture directory 

pttfUTM 

Subdirectory in the hie upload directory where pictures will be stored. 

Default picture 

URL of picture to display for users with no custom picture selected. Leave blank for none. 

Picture display style 

Biumftfwil 

The style selected will be used on display, while the original image is retained. Styles may be configured in the Image styles 
administration area. 

Picture upload dimensions 
KB4X1CB4 pixels 

Pictures larger than this will be scaled down to this sire. 

Picture upload file size 
MO KB 

Maximum allowed file size for uploaded pictures. Upload size is normally limited only by the PHP maximum post and file 
upload settings, and images are automatically scaled down to the dimensions specified above. 

Picture guidelines 


This text is displayed at the picture upload form in addition to the default guidelines. It's useful for helping or instructing your 
users. 


© The Personalization section of the Account settings screen 
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4 . The remainder of the settings in the 
Personalization section are for deter¬ 
mining how user graphics are managed. 

► Picture directory: Specifies what sub¬ 
folder inside /sites/default/files 
will store avatar graphics. Drupal is 
quite fault-tolerant about this: If you 
name a directory that doesn’t already 
exist on your server, Drupal attempts 
to automatically create it, and if you 
later change the directory, Drupal 
tries to figure out where to find the 
files. The path here should not have 

a leading slash, so pictures/users is 
correct while /pictures/users is not. 

► Default picture: Lets you specify an 
avatar for all users who don’t choose 
their own. As with the “Picture direc¬ 
tory” field, the path should not have 
a leading slash. 

► Picture display style: Tells Drupal 
which image style to apply to user 
avatars. The pop-up menu lists all 
image styles in your Drupal installa¬ 
tion: The default one automatically 
scales avatars to 100 pixels square. 


To learn how to change these set¬ 
tings, see the section “To create or 
edit image styles” in Chapter 5, “Mak¬ 
ing Content Interactive.” 

► Picture upload dimensions and Pic¬ 
ture upload file size fields: Let you set 
the maximum allowable avatar size in 
pixels (in the format widthxheight) 
and kilobytes, respectively. Users 
see these restrictions next to the 
file-upload field when they upload 
their avatars, and Drupal rejects any 
attempts to upload graphics larger 
than the allowable sizes. 

► Picture guidelines: Lets you can 
give instructions to users who are 
about to upload their avatars, in text 
that appears next to the file-size 
warnings ©. 

5 . The rest of this screen lets you change 
the text of email messages sent to 
users, as is described in the next sec¬ 
tion, “To modify automated administra¬ 
tion emails and determine when to send 
them.” When you’ve made the desired 
changes, scroll to the bottom of the 
screen and click “Save configuration.” 


Picture 

Hplimcl pii'tiiir 
(rhrxKP FI If ) no fill* selec ti»d 

Vour virtual fact or picture. Pictures larger than 1024x1024 pixels will be scaled 
down. Avatar must a photo of your face. 


© Guidance that users see when they upload avatars, 
including the custom text “Avatar must be a photo of 
your face.” 
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© The section of the Account settings page 
where you can change email messages sent 
to users 



Q Settings for some administrative messages 
include a check box to determine whether Drupal 
will send the message at all 


To modify automated 
administration emails and 
determine when to send them: 

1. Click Configuration in the Toolbar and 
then click “Account settings.” 

2 . Scroll down to the E-mails section ©. 

3 . Clicking any of the eight links on the left 
shows you the text of an email message 
that’s sent to users under a specific 
circumstance, such as when you create 
accounts for them. 

Three of these message types—for 
account activation, account blocking, 
and account cancelation—offer you 
a check box to determine whether to 
send email when the action occurs Q. 
Drupal always sends a message for the 
other five actions described. 

4 . To change the text of any of these email 
messages, simply click its tab and start 
typing in the Subject or Body fields. 

In addition to static text, you can 
enter dynamic “variables” that Drupal 
replaces with items specific to that user. 
In ©, when Drupal sends one of these 
emails to the user jimbo, it replaces 
the text [usertname] with jimbo. The 
meanings of most of the variables that 
you can use are obvious, but here are 
clarifications for those that aren’t: 

► [site:name] is the site’s name—in our 
example that’s Sunrader Fans. 

► [site:url] is the site’s main page, 
which we’ve referred to in this book 

as bttp://domain-name. 

► [site:url_brief] removes 
the http:// part, delivering just 
domain-name. 


continues on next page 
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► [site:login_url] is always http:// 
domain-name /user unless you explic¬ 
itly change it. 

► [user:edit_url] goes to the user’s 
page for editing the account, gen¬ 
erally http://domain-name/usei/ 
user-ID/e dit, where user-ID is the 

serial number Drupal associated with 
the user’s account. (The superuser’s 
account has a user ID of 1, the second 
account created has a user ID of 2, 
and so on.) 

► [user:one-time-login-url] and 
[user:cancel-url] are addresses on 
your site for the user to log in to or 
cancel the account. The login_url 
is generally in the form of http:// 
domain-name /user/reset /user-ID! 
timestamp/random-hexadecimal 
-number. The URL is only valid for 
24 hours. 

5 . When you’ve made the desired 
changes, scroll to the bottom of the 
screen and click “Save configuration.” 


What About International Users? 

There’s one large area of Drupal we 
haven’t talked about: internationalization. 
Possibly because it’s been so successful 
outside its birth country of Belgium, Dru¬ 
pal has extensive controls for present¬ 
ing your site in ways that are friendly to 
people in many countries, using many 
languages, and with varying standards 
for time and measurement. 

Mastery of internationalization (com¬ 
monly known as i18n to denote the many 
letters between the first and last) and 
localization ( HOn) are crucial to anyone 
planning to launch an international site. 
But they’re also complex subjects with 
many questions that need addressing. 
For example: Which parts of the site will 
you translate? If some languages read 
from right to left, how does that affect 
your layout? Are there local legal or cul¬ 
tural issues that could affect ilSn? 

We won’t go into these details here, 
except to direct you to turn on the 
Locale module that provide controls for 
many of them. You can do so by click¬ 
ing Modules in the Toolbar, clicking the 
Locale check box, and then clicking 
“Save configuration” at the bottom of 
the screen. You then see new options 
in the “Regional and Language” sec¬ 
tion when you click Configuration in the 
Toolbar. If you have further questions, 
the best place to find answers is in the 
Internationalization discussion group at 
http://groups.drupal.org/il8n. 
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Defining User Roles 
and Permissions 

Drupal’s security structure rests on two 
pillars: 

■ Categorizing users into roles 

■ Granting appropriate permissions to all 
users in a role 

At first, this approach seems unwieldy. Let’s 
say, for example, that you’ve just hired two 
people: one who needs to create, edit, 
and delete nodes, and another who’ll be 
managing site users. It would be conve¬ 
nient to just edit the user accounts of those 
two people to grant those permissions. But 
Drupal doesn’t work that way. Instead, you: 

1. Create two new roles, such as “content 
manager” and “community manager.” 

2 . Define permissions for those roles. 

3 . Apply those roles to the users who 
should have them. 

The benefit of such a system is that it 
scales quite well. If your site becomes a 
huge success and you need to hire other 
people to manage it, you’ll be able to give 
them the same permissions as their col¬ 
leagues simply by selecting a check box in 
their user profiles. This role-based system 
encourages easy-to-maintain security 
practices: It’s a lot easier to keep track of 
permission settings on a handful of roles 
than on thousands of users. 
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To add and delete user roles: 


1. Click People in the Toolbar, then click 
the Permissions tab, followed by the 
Roles button ©. This will bring you to 
the Roles administration page ©. 

2 . Enter the name of the role you want to 
add in the blank field on the last line, 
then click “Add role.” 

You can enter pretty much any text 
as the role name, including punctua¬ 
tion and eight-bit characters such as 
a and •. 

3 . Drupal adds the role to the list. To 
delete the role or change its name, 
click the “edit role” link to go to the 
Edit role page. Then click the Delete 
role button 0. 

4 . You can change permissions associ¬ 
ated with this role by clicking the “edit 
permissions” link on the Roles admin¬ 
istration page seen in Q. If you do, 
however, you’ll see permissions for 
only that role, and you won’t be able to 
compare them to those of other roles. 
For a better way to edit permissions, 
see the section “To change user access 
permissions.” 



© The Roles button appearing after you click the 
Permissions tab 



© The Roles administration page, shown during 
the addition of a “content manager” role 



© Deleting the “content manager” role 


<2D You can’t delete or change the names of 
the “anonymous user” or “authenticated user” 
roles: They’re essential parts of the Drupal 
software itself. 
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Account settings • 



O Controls on the Account settings page that 
affect the anonymous user and administrator roles 


To better define the administrator 
and anonymous user roles: 

1. Click Configuration in the Toolbar and 
then click “Account settings.” We’ll 
examine only the first two sections of 
this page, labeled “Anonymous users" 
and “Administrator role” ©■ 

2 . The first section on this screen lets you 
change the way that Drupal refers to 
anonymous users—that is, those who 
haven’t logged in to an account on your 
site. This mostly comes into play when 
you allow them to post content on your 
site, as the name you specify here typi¬ 
cally appears near the content’s title. 

Some sites use this setting as a way 
to encourage site registrations. For 
example, the popular technology site 
slashdot.org has called unregistered 
users “Anonymous Cowards” for years. 

continues on next page 


What's So Special About the Administrator Role? 

Drupal’s developers created the administrator role for Drupal 7 because many Drupal sites have 
multiple administrators. To manage this arrangement in previous versions of Drupal, you needed 
to either share the superuser account among several people—a terrible practice in terms of 
security—or create a role with all the permissions turned on. Since the latter is the better option, 
it became part of Drupal 7. 

However, a user with the administrator role does not have exactly the same power as the super- 
user. For one thing, the superuser’s powers are irrevocable, while you can turn off permissions for 
administrator users. 

But there’s one thing about the administrator role that’s particularly handy: Whenever you install 
and enable a new module, users with the administrator role automatically gain power to administer 
it. However, administrators don’t automatically gain permission to create nodes of newly made 
content types. 

To learn how to grant and revoke specific administrator powers, see the section “To change user 
access permissions.” 
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3 . The “Administrator role” section has 
a pop-up menu that includes Dru- 
pal’s special administrator role, all the 
roles you’ve created, and a “disabled” 
option © Select the role that you’d 
like to have administrator privileges: 
Whenever you install and enable a new 
module, members of that role will have 
permission to use all its features. 

4 . When you’ve made the changes you 
want, scroll to the bottom of the screen 
and click “Save configuration.” 

To change an individual user's roles: 

1. You can change the roles held by an 
individual user by editing that user’s 
profile page. There are many ways to 
reach that page, among them: 

► Click People in the Toolbar and look 
through the list of users, filtering as 
necessary until you find the user; then 
click the “edit” link in that user’s row. 
For more information about using 
controls on this page, see the section 
“To view a list of user accounts.” 

► Click the user’s name that shows up 
next to content that the user created, 
and then click the Edit tab. 

► Enter the user’s name in the search 
box on the front page, click Users on 
the resulting page, click the user’s 
name, and then click the Edit tab. 

2 . Scroll down to the Roles section of the 
user edit page. Click the check boxes 
as desired to select and deselect the 
roles this user should have Q. 

3 . When you’ve made all the changes you 
want, scroll to the bottom of the screen 
and click Save. 


Administrator role 

administrator 


administrator 


content manager 
community manager 
disabled 


© Options for assigning 
a role to receive all 
permissions, including 
two custom roles 


Roles 

V authenticated user 

□ administrator 
(jS content manager 

□ community manager 


Q Adding the 
“content manager” 
role via the user 
edit page 
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0 Adding the “content manager” role to all 
indicated users 


To change the roles of 
multiple users: 

1. Go to the People administration page 
by clicking People in the Toolbar. 

2 . Sort and filter the list, as you learned 
in the section “To view a list of user 
accounts.” 

3 . Choose the accounts you want to affect 
by selecting the check boxes next to 
their names. 

4 . In the Update Options section, select 
the role you want to add to those users 
under the “Add a role to the selected 
users” option © To remove roles 
from those users, select the role under 
the “Remove a role from the selected 
users” option. 

5 . Click the Update button. The People 
administration page reloads, with the 
appropriate roles applied to the users 
you selected. 
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To change user access permissions: 

1. Click People in the Toolbar and then 
click Permissions to go to the Permis¬ 
sions screen © 

2 . To grant a permission, select the check 
box for the permission you want to 
grant and the role to which you want 
to grant it. 

This screen can seem overwhelming 
at first, with over 100 check boxes. But 
it’s a lot easier to deal with when you 
understand its basic structure: 

► Each column is a role. When you 
select a check box in that column, 
you are giving permissions to all 
users who have that role. (For details, 
see the sections on roles earlier in 
this chapter.) 

► Each row is a permission: Such as 
“Access user profiles” or “Create new 


Article content.” By selecting a check 
box in this row, you’re granting that 
specific permission to a role. 

► Permissions appear grouped accord¬ 
ing to the module that controls them. 
The heart of Drupal is a collection 
of modules, and you can add other 
modules to extend Drupal’s func¬ 
tionality. (For details, see Chapter 9, 
“Extending Drupal with Modules.”) 

3 . When you’ve adjusted permissions as 
you like, click “Save permissions.” 

GD Except for the anonymous user role, you 
can give a role only to someone who has a 
user name and password on your system—that 
is, to an authenticated user. Conversely, every 
person with a (non-anonymous) role is also an 
authenticated user. When you grant a permis¬ 
sion to authenticated users, Drupal automati¬ 
cally grants it also to all non-anonymous roles. 


• Mmniiiranon • Procur 


Rofts 


Permissions In you control what uteri can do and te« on your m«. You can define a ipeciftc tet of permtstiont for each role. (See the 
Holes page to create a role). Two important roles to const)er are Authenticated Users and Administrators- Any permissions granted to the 
Authenticated Uteri role wdl be given to any uter who can log into your me. You can make any role the Administrator role for the ute. 
meaning this will be granted all new permissions automatically You can do this on the User Settings page You should be careful to ensure 
that only trotted uteri are given tbit access and level of control of your tite. 

Hide descriptions 
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© A portion of the Permissions screen, showing Drupal’s three default roles 
and the two additional roles we created 
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O Links to Help, Permissions, and Configuration 
pages for specific modules 



©The Administration link that’s available on 
every administrative page 


To find permission settings 
for a specific module: 

1. There are two places in Drupal with 
links to permissions for specific mod¬ 
ules. The first is on the Modules page: 
To go there, click Modules in the Tool¬ 
bar. Next to some modules are Help, 
Permissions, and Configure links that 
take you directly to those controls O. 

2 . The second place where you can reach 
specific permissions settings is on the 
Administration page, which has no 
direct link through the Toolbar. To get 
there, go to any administrative page 
and click the Administration link in the 
upper-left corner ©. (This is part of a 
string of links known as “breadcrumbs” 
that shows you where you are in rela¬ 
tion to other administrative pages.) 

On the Administration page, click the 
Index tab to see controls categorized 
by module © then click the permis¬ 
sions link under the relevant module. 

Whichever method you use, Drupal takes 
you directly to the relevant section on the 
Permissions page. 


Administration ® 


“S 


This pagr Hunt you *11 Available administration tasks for each module 


H«de descriptions 


BLOCK 

COMMENT 

Q Blocks 

Configure what block content appears in your she's sidebars and 
otlwr ragions 

Q Comments 

list and edit site comments and the comment approval Queue. 

Q Configure Block permissions 

Q Configure Comment permissions 

CONTEXTUAL LINKS 

DASHBOARD 

Q Configure Contextual links permissions 

Q Dashboard (Administration) 

View and customlt* your dashboard 

DATABASE LOGGING 

Q Dashboard (Structure) 

Configure which blocks can be shown on the dashboard. 

Q Recent log messages 

View events that have recently been logged. 

Q Configure Dashboard permissions 


o A portion of the Administration page, with the Index tab selected 
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So Many Permission Settings... Which Are Important? 

Version 7 is the first release of Drupal to undergo a thorough user-interface audit. Noted designer 
Mark Boulton led the charge, thanks to major funding from Drupal consultancy Acquia and contri¬ 
butions of time by hundreds of volunteers. 

But the Permissions screen remains a bit of a bear. It’s burdened with irreducible complexity, and 
the sea of check boxes so far appears to be the best way to address it. 

After you’ve been using Drupal for a while, the complexity fades away because you’ll find that you 
keep coming back to the same few permissions settings again and again, but you almost never 
touch others. While each administrator works differently, and each site has different needs, here 
are the permissions I most often need to tweak: 

■ Grant “Post comments” permission to anonymous users. These comments don’t appear on the 
site immediately. Instead, they go into the Approval queue, which you’ll learn about in the sec¬ 
tion “To moderate comment spam.” Only grant this permission if you have the time to browse 
and act on the approval queue frequently—at least once a day is usually fine for sites with 
moderate traffic. 

■ Grant permissions to create, edit, and delete nodes of various content types to the appropri¬ 
ate roles. Administrators often forget to grant such permissions in the Node module to allow 
content growth. 

■ Grant “Use search” and “Use advanced search” permissions to anonymous and authenticated 
users. 

■ Grant “View user profiles,” “Change own username,” and “Cancel own user account” permis¬ 
sions to authenticated users—assuming that you run a fairly open site, and feel you can trust 
your users enough. 
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Building and 
Protecting Your 
User Community 

Many online businesses fail for lack of 
an audience. If your site relies on user- 
contributed content and interaction, it 
won’t live long unless it attracts people 
and keeps them coming back for more. 

Early web sites did so through a variety 
of gimmicks, such as prize drawings and 
outright cash bribes. Then entrepreneurs 
realized that the promise of human contact 
was just as compelling—and a lot cheaper. 
And so the boom in online social network¬ 
ing began. 

You’ve already learned how to use some 
of the tools that encourage social network¬ 
ing, such as forums, blogs, and polls. Some 
methods to create community are more 
subtle. Allowing users to apply tags to 
stories, for example, gives them a small- 
but-satisfying sense of power, while distrib¬ 
uting the hard work of categorizing content 
among many people through a technique 
known as crowdsourcing. (Read about tag¬ 
ging in the section “Categorizing Content 
with Taxonomies” in Chapter 5.) 

This section gives you three other ways to 
build community. You’ll learn how to: 

■ Let users know each other through 
profiles they create. 

■ Enable contact forms so they can con¬ 
tact each other directly. 

■ Prevent comment spam, an extremely 
common problem that pollutes the river 
of human interaction. 


Wrangling Users 171 




To add fields to user profiles: 

1. Drupal gives every user a profile with 
just enough information to maintain the 
account: user name, password, and so 
on. But you can add fields to those pro¬ 
files through a process much like the 
one you learned in Chapter 4, “Custom¬ 
izing Content,” to add fields to content 
types. 

We’ll demonstrate by adding a field that 
lets users tell the world what vehicles 
they own. This information shows up 
on each user’s profile, which is visible 
on the page at http -.//domain-name/ 
user/user-ID to everyone with the 
“View user profiles” permission. (By 
default, only administrators have this 
permission. To learn how to make it 
more widely available, see the section 
“To change user access permissions” 
earlier in this chapter.) 

Controls to add fields are on the 
Account settings page. To get there, 
click Configuration in the Toolbar and 
then click “Account settings.” 


2 . Click the “Manage fields” tab to see 
what fields are already part of user 
profiles ©. Two fields are there by 
default: “User name and password” 
and “Timezone.” You can move them, 
but you can’t turn them off. 

3 . Now you add fields in the same man¬ 
ner as you learned in the section “To 
add fields to a custom content type” in 
Chapter 4. By way of demonstration, 
we’ll add a field titled “Sunraders I own.” 

In the “Add new field” area, enter a 
human-readable name and a machine- 
readable name. Then select which type 
of information the field will contain and 
the “widget” that determines how that 
information is collected. (I’ve chosen 
the Text field type and the “Text field” 
widget for our example.) Click Save. 

4 . You’ll now need to decide on various 
criteria, such as field length, whether 
it’s a required field, and so forth. These 
options will vary depending on the field 
type you selected. 

When you’ve finished filling out the field 
settings pages, click “Save settings.” 


Account settings 
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© The screen where you can change what fields are part of user profiles 


172 Chapter 7 







© The “Sunraders I own” multiple-value field 
in the user edit form, with the built-in “Locale 
settings” field above it 


Sunrader Fred 

Sunraders I own: 

1986 Adventure-H 
1986 Monterey 

History 

Member for 

7 hours 9 min 


© Viewing a profile that contains our 
newly added field 


5 . Drupal returns you to the Manage fields 
page, with your new field in place. You 
can change the order of fields as they’ll 
appear in profiles by dragging them by 
their handles and clicking Save. 
Likewise, you can change their appear¬ 
ance by clicking the “Manage display” 
tab and altering their default settings. 
For help, see the “To change a field’s 
display and input options” section in 
Chapter 4. 

Now when users edit their profiles, 
they’ll see a field where they can fill 
in the information you requested ©. 
When others view a profile, they’ll see 
what the user put in that field ©. 


What About the Profile Module? 

If you manage a Drupal 6 site, you might have noticed that the Profile module lets you add fields to 
user profiles in a manner very similar to what you saw here. You might also have noticed that the 
Profile module is still there in Drupal 7, although it’s disabled by default. So why not use it? 

The fact is, you could, and your users would never know the difference. However, the method you 
learned here is much more in line with Drupal’s future architecture. Before, profiles and nodes 
were based on completely different field systems; now, both are “entities,” equally able to enjoy 
Drupal 7’s advances in field handling. (Comments and taxonomy terms are also entities.) How 
important is that? Well, Drupal creator Dries Buytaert called the introduction of entities “the big¬ 
gest architecture change in the history of Drupal” in July of 2010. 

The Profile module, by comparison, is only there to allow sites to keep profiles intact when 
migrated from Drupal 6 to Drupal 7. But Drupal 8 won’t support those old-format profiles. So if 
you’re building a new site, the choice is clear: Create profiles using the modern field system and 
avoid the Profile module. 


Wrangling Users 173 







To provide a form for users to 
contact you (and each other): 

1. Click Modules in the Toolbar to go to 
the Modules page. 

2 . Enable the Contact module by select¬ 
ing its check box. Scroll to the bot¬ 
tom of the screen and click “Save 
configuration.” 

3 . Your contact form is now enabled and 
will send emails to the site address you 
entered when you created the site. 

By default, only users with the admin¬ 
istrator role can use it. We’ll make it 
available to everybody by changing its 
permissions. 


To do so, click People in the Toolbar 
and then click Permissions. Scroll 
down and grant the “Use the site-wide 
contact form” permission to those roles 
you’d like to have it. (You can also allow 
users to contact each other through 
individual contact forms by selecting 
the “Use users’ personal contact forms” 
permission.) When finished, scroll to the 
bottom and click “Save permissions.” 

4 . To change the contact form’s features, 
click Structure in the Toolbar and then 
click “Contact form.” On the resulting 
page is a list of contact categories that 
contains one entry, labeled “Website 
feedback.” Click Edit in that row to go to 
that category’s configuration page ©. 



© Editing the “Website feedback” contact category 
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5 . Fill out the resulting form. Its fields are: 

► Category: What users see in a pop-up 
menu on the contact form. Typical 
categories are “Business inquiries,” 
“Technical problems,” and so forth. 

► Recipients: Determines where these 
messages will go. If you want them to 
go to multiple recipients, separate the 
email addresses with commas. 

► Auto-reply: Tells Drupal to send an 
email message to people who fill out 
the form. Such a message is a nicety, 
letting them know that you’ll respond 
to the message as soon as possible. 
Enter the text of the message you’d 
like Drupal to send. 

If the person trying to reach you 
using the contact form is an authen¬ 
ticated user, Drupal uses the email 
address from the user’s profile. 

Drupal prompts anonymous users 
to provide an email address in the 
contact form. However, it doesn’t 
authenticate those addresses in any 
way, so there’s no guarantee that 
your auto-reply message will reach 
the correspondent. 


► Weight: As elsewhere in Drupal, lets 
you put this category before or after 
others in the contact form’s pop-up 
menu. 

► Selected: Determines whether the 
contact form will use this category 
if the user doesn’t select any other. 
Whenever you set this field to Yes 
on a category, Drupal automatically 
changes it to No on all other cat¬ 
egories so that only one category is 
ever pre-selected. If you don’t set the 
Selected field to Yes on any catego¬ 
ries, then Drupal will prompt people 
using the contact form to select a 
category. 

When you’ve filled out this form, click 
Save. 

6 . You can set up additional contact cat¬ 
egories by clicking the “Add category” 
link on the Contact form administration 
page, filling out the form, and clicking 
Save. 

7 . Your contact form is now ready! Users 
with sufficient permission who go to 

http://domain-name/contact see it ©. 

continues on next page 


Contact 

Your name * 

Jimbo Jones 

Your e-mail address' 

Jlmbo@cxampic.com 

Nuty«ct* 

Tound a broken link 

Category • 

MMnlt* «m»Mck : 

Me caa jr * 

THanks for the great site* I just wanted to let you know that the link to your 
personal sitp from the seems to be broken from the ‘About* page. 

Keep up the good wo*k'| 


Send 


© A typical contact form, as an anonymous user 
sees it before typing and sending a message 
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8 . You (or individual users) can also turn 
on personal contact forms that allow 
users to contact each other. 

First, go to the profile page of the user 
you’d like to be able to receive contact 
email. As the administrator, you’d do 
this by clicking People in the Toolbar 
and then clicking “edit” next to the 
user’s name; the user would do this by 
clicking “My account” and then clicking 
the Edit tab. 

Then, scroll down and select the 
“Personal contact form” check box and 
click Save Q. 

Now users with both the “View user 
profiles” and “Use users’ personal con¬ 
tact forms” permissions can contact that 
user by going to the appropriate user 
page and clicking the Contact tab. 


▼ Contact settings 


% 


Personal contact form 


Allow other users to contact you via a personal contact form which keeps your e- 
mail address hidden. Note that some privileged users such as site administrators 
are. stiff ahfe. to contact you even if you choose to disable this feature. 


Q Enabling a personal contact form on the user’s profile 
edit page 
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To moderate comment spam: 

1. Go to the Permissions page by clicking 
People in the Toolbar and then clicking 
the Permissions tab. Ensure that the 
“Skip comment approval” permission is 
not selected for the roles whose com¬ 
ments you want to moderate. 

2 . Users who have the “Post comments” 
permission but not the “Skip comment 
approval” permission see a message 
at the top of the resulting page after 
attempting to post a comment on your 
site. (“Your comment has been queued 
for review by site administrators and 
will be published after approval.’’) In 
addition, Drupal sends the administra¬ 
tive email address a message that says 
a comment is waiting for your approval. 
That email message includes a URL that 
takes you to the Approval queue, at 

II domain-name! aAmi.nl content! 
comment/approval. 


3 . When you go to that page, you see 
a list of comments awaiting approval. 
(You can also go to that page by click¬ 
ing Content, clicking the Comments 
tab, and then clicking the “Unapproved 
comments” button.) 

Select the check boxes of those com¬ 
ments you want to either approve 
(“publish”) or delete. Then select the 
appropriate option from the “Update 
options” pop-up menu and click 
Update 0 . 

GD Think hard before granting the “Skip 
comment approval” permission to anonymous 
users if your site is visible to the entire Inter¬ 
net. Any area where a comment can be posted 
will fill to the brim with spam. If you have the 
time, I recommend you moderate comments 
from authenticated users as well, as some 
spammers now use scripts that automatically 
join Drupal sites just to become “authenti¬ 
cated” enough to spam your site. 



0 The comment approval queue, as seen during the process of deleting 
a spam message 
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Customizing Drupal's 
Look and Feel 


Drupal is first and foremost a functional 
tool. You feed it data in the form of text 
and graphics, and it spits them back at you 
in controlled and useful ways. But it’s not 
a completely colorless tool. Members of 
the Drupal community have made unprec¬ 
edented efforts to improve the software’s 
appearance and interactivity—its “look 
and feel.” 

And yet designing for Drupal remains 
somewhat difficult, relying on text-based 
tools to change Cascading Style Sheets 
(CSS) and PHP code. Very little in Drupal’s 
layout system has a drag-and-drop inter¬ 
face, and there are few handles to resize 
objects. Further, you control how design 
files interact with each other by configuring 
a .info file that’s entirely unique to Drupal. 

But as is typical in Drupal, you’re rewarded 
for your efforts with an extremely high level 
of flexibility. With a rudimentary knowledge 
of HTML and CSS, coupled with the tips 
you’ll learn here, you’ll know enough to 
make substantial and effective changes 
to your site’s appearance. For much, 
much more about Drupal theming, see 
drupal.org/theme-guide. 


In This Chapter 
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180 
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Creating a New Theme 

A new Drupal themer’s temptation is to try 
to write a first theme from scratch. That’s 
a valuable way to learn theming from the 
ground up, but unnecessary. With dozens 
of well-constructed themes available for 
free download at drupal.org/project/ 
themes, it’s much easier to simply modify 
an existing theme. That can also be a 
better way to learn, since many existing 
themes incorporate standards and tricks 
that aren’t obvious from a cold reading of 
the theming guide on Drupal.org. 

We’re going to start by basing our new 
theme on one that’s very simple, but I 
want to reiterate that you can build your 
own theme on the shoulders of any 
Drupal theme—assuming, of course, 
that its copyright permits that use. (All 
Drupal core themes and those found on 
drupal.org/project/themes are licensed 
under the GNU Public License, which 
explicitly allows such use as long as the 
derived work also permits such modifica¬ 
tion. For details, see gnu.org/copyleft/ 
gpl.html.) 

It’s amazing what a difference small 
changes can make. Often, you can satisfy 
your design needs by simply replacing a 
few graphics, colors, or CSS classes. On 
that note, this is a good time to review 
the section “Selecting a Visual Theme” in 
Chapter 2, “Establishing Your Drupai Site,” 
for a reminder on how to change basic 
theme settings—for example, to replace 
the theme’s default logo with your own. 
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To duplicate and rename 
an existing theme: 

1. In your computer’s file system, find the 
theme you want to copy. This could be 
either a core theme (which you’ll find 
in the /themes folder of your Drupal 
installation) or a theme you downloaded 
earlier from drupal.org/project/ 
themes. (For more information about 
downloading themes, see the section 
“To find, download, install, and enable 
an alternative theme” in Chapter 2.) 

New in Drupal 7 is a bare-bones theme 
named Stark that we’ll use as a basis 
for our changes. In practice, you’ll often 
start with a more complete theme, but 
the less-complex and less-distracting 
Stark is better for our purposes. 


2 . Copy the theme’s entire folder (in this 
case, /themes/stark) to inside either 
/sites/all/themes, /sites/default/ 
themes, or another appropriate folder 
if you’re running a multisite installation. 
(For further direction, see the sidebar 
“Understanding the sites Folder” in 
Chapter 2.) 

3 . Inside this new folder, you’ll find one 
file that ends in .info— in our case, 
that’s stark.info. Rename the file 
to what you want for the theme’s 
machine-reodoble name. (You’ll give it 
the human-readable name in another 
step.) In our example, I’ve renamed it 
peachpit.info. 

Rename the theme’s enclosing folder 
with the same name so that it’s clear 
both to you and to Drupal itself ©. 

continues on next page 



© Renaming the theme’s .info file and enclosing folder 
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4. Now you’re going to edit the newly 
renamed .info file to add the human- 
readable name and several other 
important pieces of information. Open 
it with a text editor, such as Mac OS X 
TextEdit, Windows Notepad, or *nix 
nano ©. 

5. The .info file has several parts, which 
the theming guide at drupal.org/ 
node/925532 will explain in great detail. 
(Parts of this guide are incomplete as 

I write this. You may be able to fill in 
some of the gaps by looking at the 
Drupal 6 theming guide at drupal.org/ 
theme-guide/6. In particular, see “Struc¬ 
ture of the .info file” at drupal.org/ 

node/171205.) 

The only part you need to change is 
the “name” line, shown as Line 2 in 
Whatever you put here becomes the 
human-readable name of the theme, 
which appears on the Appearance 
page. Any changes that you make to the 
“description” (Line 3) also show up there. 

Both the first line and Lines 10-14 are 
added automatically to themes that are 
distributed through the Drupal proj¬ 
ect’s web site at drupal.org and don’t 
directly affect your installation of Drupal. 
There’s no need to change them unless 
you plan to redistribute your theme 
through the drupal.org web site. 

6 . In a web browser, go to the Appearance 
page by clicking Appearance in the 
Toolbar. You now see your theme along¬ 
side any core and contributed themes 
you’ve installed ©. You can enable 

it in the same way you learned in the 
section “Selecting a Visual Theme” in 
Chapter 2. 



© The peachpit.info file opened in the Mac 
program TextWrangler, before applying any 
changes to it 



© The Appearance page, showing the newly 
created Peachpit theme next to the Stark theme 
on which it was based 
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Why Not Just Change the 
Existing Theme? 

You may wonder why we bothered to 
copy the Stark theme. Couldn’t we have 
just renamed it and changed it where 
it was? 

The short answer is: Yes, we could have. 
But doing so would violate the central 
rule of Drupal development: Never touch 
anything outside the /sites folder. Or, 
as experienced Drupal developers fre¬ 
quently warn: Don’t hack core. 

There are several reasons why: 

■ Any changes you make in the 
/themes directory (instead of /sites/ 
all/themes or similar) will simply be 
wiped out when you update Drupal, 
as you’ll probably do about every 
month or two. (See the section “To 
update Drupal” in Chapter 2 for 
details.) 

■ Your changes will be hard to track, 
because anybody else who’s tasked 
with administering your Drupal site 
will look for theme changes inside the 
/sites folder. 

■ Making changes directly to Stark pre¬ 
vents you from easily “rolling back” 
to its original, core version should 
problems arise. 

Fortunately, Drupal’s design makes 
modifying anything outside the /sites 
directory unnecessary. Its architecture 
specifically allows you to make any 
changes you could possibly want within 
that directory—you only need to learn 
to do things “The Drupal Way.” That way 
is not always obvious, but one dictum is 
clear: Don’t hack core. 


GD You can add HTML styling to the 
“description” field in the .info file. In ©, 
you can see that I’ve added the <em> tag 
to the word Stark. 

GD As with any other Drupal development, 
you should work on a backup of the site, not 
its live version. Theming errors could make the 
site difficult to navigate or even inaccessible. 

GD Although we’re using Stark to build 
our new theme, a note in its layout.css file 
warns that it “shouldn’t be used on a produc¬ 
tion site because it can break.” Its weaknesses 
are fixable with good CSS, however. If you pre¬ 
fer to start with something a little more robust, 
you can reuse any Drupal 7 theme you find at 
drupal.org/project/themes. 

GD You might also want to create your new 
theme using a different technique on top of 
themes designed as “base themes,” such 
as Basic (drupal.org/project/basic). 
Genesis (drupal.org/project/genesis), 

Zen (drupal.org/project/zen), or NineSixty 
(drupal.org/project/ninesixty). Several 
of these come with excellent documentation. 

GD When you have developed your theme 
to a point where its basic appearance won’t 
change much, replace the 150-by-90-pixel 
screen shot file (as was shown in o> that 
gives administrators a preview of the theme 
on the theme administration page. You 
can specify the screen shot’s name in the 
.info file by adding the line screenshot 
= path/filename, ext. If you don’t specify 
a location, the theme looks for a file named 
screenshot, png at the top level of the 
theme’s directory. 
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Changing Theme 
Graphics and 
Typography with CSS 

If you’ve studied CSS, you know that 
there are three ways to include styles in 
a web page: 

■ Inline styles: Temporary instructions 
defined immediately before the content 
they affect. 

■ Internal styles: Defined at the top of an 
HTML page and affect only that page. 

■ External styles: Contained in a separate 
text document that’s referenced from 
within HTML pages. 

Drupal uses all three methods to some 
extent. For example, you can style indi¬ 
vidual snippets of text within a node by 
using inline styles and applying the “Full 
HTML” text format. And by adding internal 
styles to a theme’s template files—that 
is, the ones ending in tpl.php— you can 
apply changes to specific content types 
or pages. 

We’ll concern ourselves with changes 
in external styles, as they pervade your 
entire Drupal site. Implementing them is a 
two-stage process. First, edit your theme’s 
.info file to tell Drupal which external CSS 
files to use; second, create (or edit) those 
files to add the styles you want. 

We’re now entering a somewhat advanced 
area of Drupal administration, and this 
chapter is only intended to help you get 
your feet wet. The Drupal.org theming 
guide at drupal.org/theme-guide will 
take you the rest of the way. 
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package = Core 
version = VERSION 
core = 7.x 

engine = phptemplate 

sty lesheets[a11][] = layout. C3S 

sty lesheets[a11][] = local.css 


© Adding a style sheet named 
local.css as the last-loaded CSS 
document in the peachpit.info file 


To indicate a theme's CSS files: 

1. Open the .info file for the theme you 
want to change. We’ll continue using 
the Peachpit theme we created in the 
section “To duplicate and rename an 
existing theme.” 

2. In the middle of the .info file is at least 
one line that starts with stylesheets. 
This is the section where you define 
which CSS documents your Drupal 
theme uses to build pages. 

Add the names of any style sheets you 
want Drupal to use, in the following 
format: stylesheets[media-type][] 

= stylesheet-name.css. Drupal loads 
these style sheets in the order this file 

continues on next page 


Anatomy of a Drupal Theme 

For simplicity’s sake, we’ve worked with the Stark theme throughout this chapter. That simplicity 
has provided clarity, but at the expense of exposing you to the many parts found in a more com¬ 
plex theme. Look in the Garland theme’s folder (at /themes/garland) to see the difference: There 
are simply a lot more files. 

Here’s a description of those files you didn’t see in the Stark folder. Keep in mind that Garland 
is far from the most complex theme out there. Some themes have additional parts, such as files 
containing JavaScript code that spices up the theme’s user interface. 

■ Other CSS files. Garland includes several, most notably fix-ie.css (to correct bugs in Micro¬ 
soft Internet Explorer) and files ending in -rtl.css (for languages that read right to left, such 
as Arabic). 

■ A color folder contains graphics, a CSS file, and a PHP support file to make Garland a recolor- 
able theme (as was demonstrated in Chapter 2). 

■ An images folder keeps theme images from being littered throughout the theme’s top-level 
directory. 

■ Several files ending in .tpl.php. These are the theme’s template files, written in PHP to define 
where (and whether) information will appear on the screen. Template files can contain complex 
logic, and you can create different ones for individual content types or nodes. As always, the 
Drupal theming guide at drupal.org/theme-guide is a great source to learn how to do this. 
There is further information in the book Front End Drupal, co-authored by this book’s technical 
editor, Emma Jane Hogbin. 
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lists when it renders a page: If there are 
style conflicts, the last-listed style sheet 
wins. One very common practice is to 
put all custom styles into a file named 
local.css and list that filename last in 
the .info file ©. 

The media-type value denotes the 
contexts in which the style appears. 

The most common values are all, 
screen, and print, although several 
others are possible. See w 3 . 0 rg/TR/ 
CSS2l/media.html for a complete list. 

3. Save the .info file. 

4. Click Configuration in the Toolbar and 
then click Performance. Clear the theme 
cache by clicking the “Clear all caches” 
button. Drupal normally caches the 
contents of the .info file to improve 
speed, so changes to that file won’t be 
visible until you clear the cache. (A visit 
to the Appearance page also clears 
the cache.) 

5. Create and edit the style sheet docu¬ 
ment (or documents) you named in the 
.info file, as shown in the next section, 
“To add styles in a CSS file.” 


GD In practice, you could skip this step and 
just edit a theme’s existing style sheets. Resist 
the temptation! Creating a new external style 
sheet that contains your custom styles makes 
upgrading (and rolling back to earlier versions) 
a lot easier. 

GD If you clear the cache as step 4 describes 
but still don’t see the changes you expect, 
force your web browser to reload the page. 

For most browsers, the key command is Shift- 
Command-R on Mac and Shift-Control-R on 
*nix or Windows. 
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© Using the Firebug plug-in to determine which 
styles affect a specific text block on a Drupal page 


To add styles in a CSS file: 

1. Before making a change, you first have 
to discover what to change. Drupal 
conveniently adds style tags to most 
page elements in a logical fashion, 
so there are plenty of opportunities 
for styling pages. But figuring out the 
names of specific styles takes some 
detective work. 

Most Drupal themers find the task 
easier with a tool called Firebug 
(getfirebug.com) that works together 
with the Firefox browser (mozilla.com). 
With this combination, you learn what 
styles affect an object on your Drupal 
page by clicking the “Inspect element” 
icon and then the object ©. (Alter¬ 
natively, you can simply right-click an 



continues on next page 


Do I Really Need to Know CSS? 

Yes. Yes. A million times yes. 

There’s just no way around it: CSS is the 21st-century way of designing for the web, and with good 
reason. Most obviously, CSS provides an ocean of layout and styling options. But just as impor¬ 
tantly, CSS helps ensure that pages will look good on any browser, including portable devices, 
printers, and machines used by vision-impaired people. Drupal recognized its value early on, and 
its layout is now designed around CSS. 

But CSS can seem overwhelming at first, especially if you try to learn it by dissecting existing 
themes. Five or ten styles affect a typical bit of text on a Drupal page, and changing the wrong one 
can have far-reaching effects you might not see right away. On the other hand, it’s valuable to get 
practice with CSS as it’s used in Drupal, since many naming conventions appear again and again. 
So here’s what I suggest: 

■ Set up a test Drupal site where you can play around with theming as much as you want without 
worrying about the consequences. (For help, see Chapter 1, “Getting Drupal Up and Running.”) 

■ Get a good tutorial/reference book (or six!) about CSS. I recommend CSS3: Visual QuickStart 
Guide by Jason Cranford Teague. 

■ Use online resources to quickly look up CSS syntax when needed. I always find myself going 
back to the one at w3schools.com/css, which also has “sandbox” areas where you can try out 
unfamiliar CSS code. 
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element on a Windows or *nix com¬ 
puter, or Control-click on a Mac, and 
choose the “Inspect element” option 
from the pop-up menu.) You can then 
decide how specific (or general) you 
want your style changes to be by 
adding the appropriate styles to your 
custom CSS file. 

2. Add CSS styles to your custom style 
sheet. We’ll use the Peachpit theme we 
created in the section “To duplicate and 
rename an existing theme” Q. 

The following CSS code is an example 
that changes the font and several 
layout elements when added to the 
local.css file ©. 

body 

{ 

font-family: sans-serif; 

} 

#site-name { 
font-size: 2em; 

} 

ttheader { 

border-style: dotted; 
border-width: 5px; 

} 



Q The Peachpit theme before applying any style 
changes 



O The Peachpit theme with its new styles applied 
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© The repeating effect of a background-image 
tag that’s not modified by any other tags 


To add a background graphic: 

1. Use an image-processing program such 
as the GNU Image Manipulation Pro¬ 
gram (GIMP) or Photoshop to create the 
GIF, JGEP, or PNG graphic you want to 
use as the background. You could use 
an image intended to cover the entire 
screen, or just part of the screen. 

2. Move this new image into the theme’s 
folder, at either the top level or in a sub¬ 
folder. In our example, a typical location 

is /sites/all/themes/peachpit. 

3. Open one of the custom CSS files you 
designated in the .info file. If you 
haven’t created this one yet, do so by 
following the instructions in the section 
“Changing Theme Graphics and Typog¬ 
raphy with CSS.” 

4. Add CSS to reference the background 
graphic. The properties you’ll use are: 

► background-image 

► background-repeat 

► background-attachment 

► background-position 

If you’re not familiar with CSS, the 
tutorial at w3schools.com/css/css_ 
background.asp will quickly get you 
up to speed. Here’s a quick-and-dirty 
way to change the graphic behind the 
entire page (assuming your graphic is 
named background.jpg): 

body { 

background-image:url( 

'background.jpg'); 

} 

This is the simplest form of background 
image. However, there’s one problem: 

If the viewer’s screen is bigger than the 
graphic, it will repeat, possibly in unat¬ 
tractive ways ©. 

continues on next page 
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By adding the background-repeat: 
no-repeat; directive, the graphic 
appears only once Q. Here’s the code: 

body { 

background-image:url( 

'background.jpg'); 

background-repeat:no-repeat; 

} 

( and the graphics following it mix 
in a few of the styles we applied ear¬ 
lier for clarity. Of course all body tags 
need to be mixed into a single body 
declaration.) 

CSS has several other background 
properties to determine where the 
background image appears, whether it 
moves when the viewer scrolls down, 
and so forth. For more information 
about them, see w 3 .org/TR/CSS 2 / 
colors.html, 

5. Add other CSS styles to complement 
your background. Here, for example, 
the background has a gradient down 
to a light gray (#CCCCCC), but then 
abruptly cuts off. By adding a #CCCCCC 
background color behind it, the graphic 
blends in with the rest of the screen 0 . 
The complete style is: 

body 

{ 

background-image: url( 
'background.jpg'); 
background-repeat:no-repeat; 
background-color: ftCCCCCC; 

> 



© A background image with additional CSS 
styling to make it appear only once 



0 A background image blended seamlessly with 
a background color 
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Sunrader Fans 

Main menu 



Secondary menu 

Vitaxut ugea 


Welcome to Sunrader Fans 


Management itr. cm* m-** w a~»* 

• AM m te'M't • AflC^wowir* 


© A background image placed in the #header 
section so it stays within the dotted lines 



O Using Firebug to figure out what CSS styles 
affect block titles 


<n> The style in the example affects the 
entire page because it’s in the body tag, 
but you can associate a background with 
any tag. This technique is common for add¬ 
ing backgrounds to div regions that the 
theme defines, such as ftcontent, ftheader, 
#f ooter, #sidebar-f irst, and so on © 

GD Since they cover such a big area, 
background graphics can cause slow page 
loads. Try to cut down on their sizes as much 
as possible, for example by lowering image 
quality in an image-manipulation program. 
(Remember, background images function 
best when they convey a feeling rather than 
specific information.) Alternatively, use back¬ 
ground images in clever ways so they don’t 
have to be so big. In 0 , we put the back¬ 
ground on only a part of the page and let the 
background-color style cover the rest. 

GD When creating background graphics, 
make sure they won’t interfere with the text 
that will be placed on top of them. First, avoid 
images with sharp changes in color or texture; 
second, make the overall color contrast with 
the site’s text color. For black text, lighten up 
the background; for light text, use a black or 
nearly-black background. 


To add incidental graphics 

1. One way to dress up a theme is to add 
icons or other small graphics to accentu¬ 
ate titles, headings, or section changes. 
First, you need to decide what part you 
want to accentuate. We’ll add a small 
icon next to the title of all blocks, for 
example the block titles in the sidebar. 

Once again, Firebug (getfirebug.com) 
is an effective theme detective’s tool. 
(For more about Firebug, see the sec¬ 
tion “To add styles in a CSS file.”) With 
Firebug and a solid knowledge of CSS, 
you see that block titles have the <h2> 
tag and the block class. Put together in 
the unique syntax of CSS, the style we’ll 
affect is .block h2 ©. 

continues on next page 
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2. Create the graphic and move it into 
your theme’s folder, either at the 
top level or in a subfolder. The icon 
we’ll use in this demonstration is the 
info.png file in Lullacons Pack 1, a free 
set of graphics created by Nate Haug 
and licensed under the GNU General 
Public License. (You can download it 
at lullabot.com/articles/free-gpl 
-icons-lullacons-pack-l.) We’ve 
renamed the icon bullet.png. 

3. Open one of the custom CSS files you 
designated in the .info file. In the sec¬ 
tion “Changing Theme Graphics and 
Typography with CSS,” we used the 
local.css file. 

4. Add the appropriate style. Once again, 
there’s no substitute for a strong 
understanding of CSS. In our case, 
we’re going to add the graphic as a 
background image and then shift the 
text to the right of the image by adding 
padding to the text’s left. Since padding 


doesn’t affect background images, only 
the text will move, while the graphic will 
remain where we put it. 

This CSS style has three directives: 

► Specifying the graphic itself: 

background-image: url( 

'bullet.png'); 

► Making the graphic appear only once: 

background-repeat: no-repeat; 

► Moving the text to the right so it 
doesn’t appear on top of the graphic: 

padding: Opx Opx Opx 25px; 

The final style looks like this: 

.block h2 { 

background-image: url( 

'bullet.png'); 

background-repeat: no-repeat; 
padding: Opx Opx Opx 25px; 

} 

5. Save the custom CSS file and reload 
the page in your browser to see the 
change O. 


® Navigation 

► Forums 


O The result of using CSS to add a 
small icon next to block titles 
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Extending Drupa 
with Modules 


Modules are truly at the heart of Drupal. 
Besides those that come with its core 
package, a wealth of additional ones is 
free for the taking on drupal.org. 

But choosing the right modules for 
your site is a daunting task. The list at 
drupal.org/project/modules is enor¬ 
mous, running into thousands of projects. 
How do you know which are right for you? 
How can you judge whether developers 
will still maintain a module in the years to 
come? 

You have an advantage: The drupal.org 
site hosts virtually all open-source Drupal 
modules in existence, providing a single 
source to evaluate and compare modules. 
But like many oracles, it can be cryptic, and 
you sometimes have to poke around for 
the truth. This chapter gives you ways to 
determine the rightness, value, and stabil¬ 
ity of modules for your site. It also walks 
you through the process of installing and 
enabling modules, tells you how to keep 
them up to date, and helps you get the 
most from them. 


In This Chapter 

Using Modules 

Modules: The Drupal 7 Challenge 
Resources for Evaluating Modules 
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Using Modules 

When you want to add functionality that’s 
not part of core Drupal, your first stop is 
the module list at drupal.org/project/ 
modules. 

We’ll talk about how to decide which 
module is right for your site in the section 
“Resources for Evaluating Modules.” But 
for now we’ll assume that you’ve found the 
module you want and just need to install 
and configure it. 

Your job doesn’t end once the module is 
up and running: Modules, like Drupal itself, 
need updates to improve security and 
stability. And when you encounter a bug in 
a module—which happens more often than 
people like to admit—you need to know 
where to get support. 



© Copying the URL for the current Drupal 7 
version of a module 


To install, enable, and 
configure modules: 

1. For our example, we’ll use the Wysi¬ 
wyg module discussed in Chapter 4, 
“Customizing Content.” We start by 
going to the Wysiwyg project page at 

drupal.org/project/wysiwyg. 

2. Find the Download link for the latest 
Drupal 7 version of the module. At the 
time this book was written, the final ver¬ 
sion hadn’t been released. Therefore, 
you’ll need to download the develop¬ 
ment version ©. (When it’s available, 
download the Drupal 7 version from the 
“Recommended releases” list instead.) 

3. If you have a two-button mouse, right- 
click the Download link; on a Mac with a 
one-button mouse, press Control while 
clicking. Then select Copy Link Location 
from the pop-up menu. 
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Modules • 



© Installing a module via its URL 


Q Iniullttlon was complattd fucccs*fully. 

Wysiwyg 

Installed wysrwyy successfully 

• Cnabte newly added modules >n Wysiwyg 
e Administration pages 
e front page 


© Drupal’s post-installation message 


'USSR INTERS ACE 

[NAKED NAME VERSION OESCRITTION ©AERATIONS 



Save conAguratKxi 


© Enabling the Wysiwig module 


4. On your site, click Modules in the Tool¬ 
bar and then click “Install new module.” 

5. In the “Install from a URL” field, paste 
the URL you just copied and then click 
Install ©. 

6 . When Drupal has finished installing the 
module, you’ll come to a page that tells 
you “Installation was completed suc¬ 
cessfully” ©. From here, you can click 
to go to the front page or the Adminis¬ 
tration page; some modules (including 
this one) provide other links. 

7. Just-installed modules remain disabled 
until you explicitly enable them. To do 
so, click Modules in the Toolbar and 
then scroll to the bottom of the page. 
Select the module’s check box and click 
“Save configuration” ©. 

Some modules depend on others to 
work; such dependencies are shown 
on the module management page with 
the words “Requires” and “Required 
by” under a module’s description, along 
with lists of which modules are required 
or dependent. 

If you turn on a module that requires 
another, disabled module, Drupal will 
present a screen for you to confirm that 
you want to enable both modules. If you 
don’t have the module that’s required, 
Drupal won’t allow you to enable the 
one that requires it. 

If one module requires another, you 
won’t be able to disable it until you’ve 
also disabled the one that depends 
on it. As a result, you might need to 
go through the module management 
page two or more times to disable 
certain modules, because you’ll have to 
untangle layers of dependencies first. 

continues on next page 
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8 . Depending on the module, you might 
need to take additional steps to make 
it work. Unfortunately, Drupal isn’t com¬ 
pletely consistent about how it warns 
you that such steps are needed, or 
where to find the controls. A few places 
to check are: 

► The Modules page, which you reach 
by clicking Modules in the Toolbar. 
Look next to the module for a Config¬ 
ure link. (Not every module has one.) 

► The Administration page, which you 
reach by clicking Administration in 
the upper-left corner of most admin¬ 
istrative pages and then clicking the 
Index tab. (See the section “To find 
permission settings for a specific 
module” in Chapter 7, “Wrangling 
Users.”) 

► The Status report page, which you 
reach by clicking Reports in the Tool¬ 
bar and then clicking “Status report.” 
Some modules alert you to installa¬ 
tion problems this way, and include 
links to solve them. 

► The Configuration page, which you 
reach by clicking Configuration in the 
Toolbar. 
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GD Remember: If you’re using Drupal 7, you 
can use only modules designed to work with 
Drupal 7. (Believe me, I know how frustrating it 
is to find a module that’s perfect, but not avail¬ 
able for the version of Drupal you’re using. 
Them’s the breaks.) 

(ZD You can also install a module by down¬ 
loading it to your computer and then re¬ 
uploading it to your Drupal site. Simply use 
the field labeled “Upload a module or theme 
archive to install” instead of the one labeled 
“Install from a URL.” The Drupal 6 method of 
manually placing the module’s files in your 
Drupal installation still works as well. 

(ZD If you click to go from the post-installation 
page G directly to any administrative page— 
that is, any except the front page—it will appear 
without the administrative overlay. To make the 
overlay appear, go first to the front page. 

(ZD Some modules don’t have direct con¬ 
figuration pages and instead affect other parts 
of Drupal in subtle ways. One example is the 
Token module (drupal.org/project/token): 
It has no configuration page itself, but instead 
adds controls to various administrative pages. 


Modules' Lives Outside the drupal.org Web Site 

The drupal.org web site is the official source for modules and is where you can file public bug 
reports in the module’s “issues queue.” (For more about this queue, see the “To evaluate a mod¬ 
ule’s past” section in this chapter.) 

But because those modules are free software, there’s nothing to stop people from republishing 
Drupal modules on their own sites. One enterprising person named John Forsythe does something 
like that by providing an alternative module directory at drupalmodules.com, where he invites 
users to rate and discuss modules in an environment quite unlike that on the drupal.org site. 

Along the same lines, there’s nothing to stop developers from withholding their modules from the 
drupal.org repository. In fact, that site lists only modules that have been released under the GNU 
Public License (GPL), so you won’t find any modules there with proprietary (non-free) code. 

In truth, I’ve never heard of anyone attempting to sell Drupal modules to the general public. How¬ 
ever, custom module development is a profitable business, and I’d guess that there are thousands 
of client-specific Drupal modules that never find their way onto drupal.org. 
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To update installed modules: 

1. To determine whether it’s necessary 
to update any installed modules, go to 
the Available updates page by clicking 
Reports in the Toolbar and then click¬ 
ing “Available updates.” This process 
checks only enabled modules; you 
don’t need to worry about disabled 
modules, since any out-of-date code 
they contain can’t affect your site. 

2. Near the top of the page is a note that 
says when your installation of Drupal 
last checked drupal.org for new ver¬ 
sions of installed modules. Visiting this 
page automatically performs that check, 
but if you want to force Drupal to check 
again, click “Check manually” Q. 

3. If you see an icon that says you need 
to update a module—like the one next 
to the Token module in [J—click the 
Update tab. If not, no further action is 
necessary. 

4. Select the check boxes next to the 
modules you want to update. You 
can select them all by selecting the 
check box at the top of the column Q 
and then clicking “Download these 
updates.” 

5. You’ll see a progress bar as the mod¬ 
ules download, followed by a confirma¬ 
tion screen 0 



O Forcing Drupal to check for new versions of 
Drupal software and contributed modules 



Q Selecting the check box that updates all out-of- 
date modules 



0 Confirmation that Drupal downloaded new 
module versions successfully 
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Q Update w«» completed »ucce»>(uBy. Vow »ite h» been taken out of 
maintenance mode. 

token 

Installed tok*n tuccettfully 

■ Your module* have been downloaded and updated. 

• Run database updates 

• Administration pages 
a Front page 


o Confirmation that Drupal updated a module 
successfully 



6 . Back up your site’s files and database, 
following the instructions in the “Pack¬ 
aging your Drupal Site” section of 
Chapter 2, “Establishing Your Drupal 
Site.” This step is optional, but I highly 
recommend it: Module updates occa¬ 
sionally go horribly wrong and can take 
your site down with them. 

7. The check box offering to put your site 
in maintenance mode effectively takes 
it offline during the update process, 
then turns it on again when the update 
is finished. If you deselect that check 
box, there’s a chance that user activity 
could interfere with the update, or that 
data will disappear as a result. That’s 
highly unlikely, but better safe than 
sorry: Unless an unusual circumstance 
dictates otherwise, leave this check box 
selected. 

Click Continue when ready. 

8 . Drupal performs the update, then takes 
your site out of maintenance mode. 
When finished, you see a confirmation 
screen © 

9. If you were to visit the “Available 
updates” screen at this point, the warn¬ 
ing icon should have changed to an 
all-clear “Up to date” icon. However, 
you’ve updated only the module’s files: 
Your job isn’t finished until you also 
update the database. To do so, click 
“Run database updates.” 

10. The resulting screen warns you again 
to perform a backup and put the site 
in maintenance mode O. (There’s 

no need to do a backup, as we just 
backed up the site a moment ago.) 

Click Continue. 


continues on next page 
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11. The resulting screen tells you whether 
the updated modules will cause 
changes in your site’s database; click¬ 
ing the “Pending updates” link provides 
details on the changes, if any 0> 

Click the “Apply pending updates” 
button. 

12. You’ll see a progress bar, followed by a 
confirmation screen Q- Your site is now 
up to date. 

If you turned on your site’s maintenance 
mode in step 10, turn it off now. 

GD We only updated a single module—and 
then only because the page shown in (f told 
us there was an “update available,” not that 
there was a security issue. In practice, you 
might find yourself putting off non-critical 
updates until you can do several in one go. 
That process is more complex only in that 
there are more check boxes to select and 
more information to review on the page shown 
in Hj). But generally it’s the same business 
whether you’re updating one module or ten. 

iJI J What can you do if there’s an error 
when you update the database? In truth, not 
much. Sometimes the error message pro¬ 
vides advice, but usually you have only two 
options: Restore the site from backup and 
try again, possibly waiting for the module’s 
next version; or, if you’re a MySQL expert and 
deeply understand the module’s code, try 
to hack the database manually. In any case, 
you should go to the module’s issue queue 
at drupal.org/project/issues/morfule- 
name to see whether anyone’s reported the 
problem, and if there’s a solution. If not, report 
it! Doing so will help the module’s developers 
fix it faster. 



O Examining details of pending database 
changes 



o Success! Your site’s database updated without 
error. 


200 Chapter 9 






All About Module Updates 

Module updates fall into a few categories: 

■ Security fixes: Stop abuse of your site through a module’s vulnerability 

■ Bug fixes: Make the module work as expected and without errors 

■ Feature improvements and additions: Often made in response to feedback from site 
administrators 

■ Minor updates: Enhance existing features, clarify points, or affect the module’s internal 
structure 

Security and bug fixes are obviously the most urgent of these, so the reasons to update are clear: 
You want to keep your site running well and in your control. On the Available updates page, mod¬ 
ules with these sorts of updates due are generally indicated with a red “urgent” icon. 

The other two sorts of updates are only recommended, but still worth installing. Sometimes 
those minor changes address issues you didn’t even notice had been bothering you. (Most 
developers keep a close eye on user suggestions in the project’s issue queue, found at 
drupal.org/project/issues/morfuIe-nt7/ne, and implement at least some suggestions.) 

But remember: A vast majority of the modules available from the drupal.org web site were cre¬ 
ated by volunteer programmers in their spare time. As a result, they vary widely in their upkeep. 
One module may receive a substantial update monthly; another languishes for years without even 
a single patch (bug fix). Further, developers differ in what they consider urgent, so when you pick 
and choose which updates you’ll apply, you’ll never know for sure whether you’re missing anything 
important. 

So my advice is to check the Available updates page frequently and install updates as they come 
along. But be careful: Not all module versions on the drupal.org web site are ready for prime 
time, so to speak. Those that the developer believes are stable and safe appear in the Releases list 
with a light green background; those that are questionably safe have a pink background; and those 
that are considered unsafe have a red background ©. Don’t replace a module with a less-safe ver¬ 
sion unless you have a special reason to do so and are prepared to return to a safe version if you 
have problems. 


Downloads 

Recommended releases 

Version 

7.x-1.0-alpha3 

6.X-1.15 

Sjc-1.15 

Development releases 

Downloads 

Download (22.92 KB> 

Download (bJ.6i KR> 

Download U1.U kb> 

Date 

2010-0ct-07 

2010-0et-07 

2010-Aug-ll 

Links 

Notes 

Notes 

Notes 

Version 

Downloads 

Date 

Links 

7.x l .x dev 

Download (2? 9? tea) 

2010-Oct 07 

Notes 

6.x -1.x dev 

Download (67 ai 

2010-0ct-ll 

Notes 

S.x-l.x-dev 

Download (31.JSKS) 

2010-Sep-24 

Notes 

View all releases Q 


© A module’s release list, with versions 
in varying states of readiness. (All 
“Development releases" here have a 
red background, while “Recommended 
releases” have a green background.) 
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Modules: The Drupal 7 
Challenge 

Drupal’s cheerleaders sometimes point to 
the “thousands” of modules available for 
it. But that number is false. While drupal. 
org/project/modules ostensibly lists over 
6000 modules, each one’s compatibility is 
limited to specific versions of Drupal. More 
precisely, integer versions aren’t compat¬ 
ible, so a module written for Drupal 5 won’t 
run on Drupal 6, although it usually runs 
equally well on both Drupal 5.6 and 5.12. 

(As I write this in November 2010, about 
650 have some kind of Drupal 7 version.) 

This incompatibility among versions is the 
result of a fundamental Drupal philosophy, 
usually phrased as “the drop is always 
moving,” meaning Drupal’s developers 
are forward-looking and don’t put much 
emphasis on backward compatibility. 

So the first thing to check when you’re con¬ 
sidering a module is whether it’s compat¬ 
ible with your version of Drupal. But here’s 
the predicament: Developers can’t update 
their modules for new integer versions of 
Drupal until Drupal itself is stable. That was 
a big problem for Drupal 6, which most 
people couldn’t use for months after its 


release because the modules they needed 
simply weren’t ready. 

Remembering that issue, long-time Drupal 
contributor Moshe Weitzman proposed (on 
his blog at cyrve.com/d7cx) that develop¬ 
ers pledge to have their Drupal 7 modules 
available on the day of Drupal 7’s release, 
and that they add the text “#D7CX” to their 
module’s description on the drupal.org 
web site to make such modules easier to 
find. The results have been remarkable: 

At the time of this writing, several weeks 
before Drupal 7’s expected official release, 
over 200 modules have signed on. Among 
them are some of Drupal’s most popular 
modules, so Drupal 7 is well positioned to 
enjoy a faster adoption rate than any previ¬ 
ous version. 

Table 9.1 lists the 20 most popular mod¬ 
ules for Drupal 6 as of mid-October 2010, 
according to the statistics at drupal.org/ 
project/usage. In each case, I’ve said 
whether the module has taken the D7CX 
pledge, is in active development (but not 
taken the pledge), or has become part of 
core Drupal itself. 

Of course, the drupal.org web site 
remains your primary source of up-to-date 
information on module availability. 
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TABLE 9.1 Drupal's Top 20 Modules 


Module Name and URL 
(drupal.org/project...) 

Drupal 7 Status 

Description 

Views 

(/views) 

In active development, but has 
not taken the D7CX pledge. 

A flexibly “query builder” that lets you 
extract information from Drupal’s data 
store and present it in interesting and 
useful ways. 

Content Construction Kit (CCK) 
(/cck) 

Most of CCK is in core Drupal 7. 
The few parts that aren’t are in 
active development, but have 
not taken the D7CX pledge. 

Allows you to add fields to content 
types. See Chapter 4, “Customizing 
Content.” 

Token 

(/token) 

Most of Token is part of core 
Drupal 7. The parts that aren’t 
have taken the D7CX pledge. 

Exposes certain Drupal variables 
for entry in nodes and the like. For 
example, Token replaces [user] with 
the user’s actual name. 

Pathauto 

(/pathauto) 

Has taken the D7CX pledge. 

Creates URL paths based on patterns 
that the administrator defines. For 
example, Pathauto could assign a 
node titled “Hello, world!” the URL 

http://domain-name/hello-world. 

FileField 
(/f ilefield) 

Part of core Drupal 7. 

An extension to CCK to provide fields 
that hold (generic) uploaded files. 

Administration Menu 
(/admin_menu) 

Has taken the D7CX pledge. 

Exposes administrative links in a 
CSS/JavaScript-powered toolbar at 
the top of the screen. It’s similar to 
Drupal 7’s Toolbar, but with additional 
functionality. 

ImageField 

(/imagefield) 

Part of core Drupal 7. 

An extension to CCK to provide 
fields that hold uploaded images, 
with some controls to display those 
images. 

ImageAPI 

(/imageapi) 

Part of core Drupal 7 but has 
also taken the D7CX pledge. 
According to its developer, the 
non-core component of the 
ImageAPI module “provides 
an ImageMagick toolkit and 
extends core's toolkits to add 
an unsharpen mask action.” 

Behind-the-scenes support for other 
image-related modules (such as 
ImageCache). 

ImageCache 

(/imagecache) 

Part of core Drupal 7. 

Automatically resizes, crops, and 
adds effects to uploaded images. 

Date 

(/date) 

Took the D7CX pledge but 
later rescinded it because of 
“significant [Drupal] API changes... 
long after [the stated] code 
freeze that forced me to rewrite 
significant portions of the code 
several times.” 

Adds a behind-the-scenes “Date API” 
that gives other modules access to 
time- and date-related functions, and 
includes an extension to CCK that 
lets you add date fields to content 
types. 

table continues on next page 
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TABLE 9.1 continued 



Module Name and URL 
(drupal.org/project...) 

Drupal 7 Status 

Description 

IMCE 

(/imce) 

In active development, but has 
not taken the D7CX pledge. 

Extends WYSIWYG editors to improve 
users’ ability to upload and place 
images in content. 

Google Analytics 

(/google_analytics) 

In active development but has 
not taken the D7CX pledge. 

Integrates Drupal with Google 

Analytics (google.com/analytics) 
to provide site usage and tracking 
statistics. 

Webform 

(/webform) 

Has taken the D7CX pledge. 

Lets you easily set up fill-in forms, the 
results of which can be mailed to a 
specified address. 

Wysiwyg 

(/Wysiwyg) 

Has taken the D7CX pledge. 

Simplifies the installation of rich-text 
editors for Drupal content. 

Poormanscron 

(/poormanscron) 

Part of core Drupal 7. 

Takes the place of *nix cron program; 
forces periodic functions to run. 

Advanced Help 
(/advanced_help) 

In active development but has 
not taken the D7CX pledge. 

Improves Drupal’s built-in help 
system by making it more context- 
sensitive, providing help links where 
they’re most needed. 

Image 

(/image) 

Part of core Drupal 7. 

Provides support to manage and 
display image files. 

CAPTCHA 

(/captcha) 

In active development but has 
not taken the D7CX pledge. 

Anti-spam tool that forces visitors 
to successfully answer a challenge 
before they can post content. The 
challenge is designed to be easy 
for people but hard for machines to 
solve, preventing automated posts. 

jQuery Ul 

(/jquery_ui) 

Part of core Drupal 7. 

Connects Drupal to a library of 
functions that provide user-interface 
effects. 


204 Chapter 9 














Resources for 
Evaluating Modules 

Confronted with hundreds of available 
modules, how can you know which to 
trust? Without good information, you might 
pick one that is nearing the end of its life 
and soon to be replaced, or is known to be 
buggy, or is inferior to another that satisfies 
your need better. 

While you can never be sure that what 
you’re getting is right for you, what fol¬ 
lows are a few tips to help you find, sort 
through, and evaluate modules. In short, 
you should consider: 

■ The module’s track record 

■ Its developer’s reputation 

■ Statements about it from its developer 
and its user base 

■ Which tool is best for the job, par¬ 
ticularly when several similar modules 
perform the same function 

Expert opinion is also invaluable forjudg¬ 
ing module quality: Who would know a 
module better than the people who use it? 
Drupal blogs such as those listed at Planet 
Drupal (drupal.org/planet) often feature 
module comparisons. One good example 
is Michael Anello’s presentation “45 
Modules in 45 Minutes: The Best Modules 
You’re Not Using” at drupaleasy.com/45; 
another is NodeOne’s series “49 Mod¬ 
ules You Should Know” at nodeone.se/ 
blogg/49-modules-you-should-know. 

Finally, the page about contributed 
modules at drupal.org/node/340271 
provides additional resources for finding 
and selecting modules for your site, while 
drupalmodules.com hosts module ratings 
and reviews. 
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To evaluate a module's past: 

1. The best way to understand a module’s 
history is to look at its issue queue. To 
get there, either: 

► Go to the module’s project page at 
drupal.org/project /module-name 
and then click one of the links in the 
Issues block in the right column ©. 

or 

► Gotodrupal.org/project/issues/ 
module-name. 

2. At the top of a module’s issues page 
are several controls that let you search 
the entire issue queue based on such 
criteria as whether a reported issue has 
been corrected (Status), how important 
the issue is (Priority), and which version 
of the module the issue affects ©. You 
can also search for any string of text, 
which is extremely helpful in figuring 
out whether an issue you’ve encoun¬ 
tered has already been reported. Click¬ 
ing “Advanced search” provides more 
search options 0. 


Issues for Views 

To avoid duplicate*, please search before 
submitting a new issue. 

(seardi) 

Advanced search 
All issues 

1044 open, 9937 t<^al 

Bug reports 

372 open, 3734 total 
Subscribe via e-mail 
Issue statistics 

Oldest open issue: 1 Mar 06 


© An Issues block on the drupal.org 
web site, with links to examine a 
project’s bug reports and feature 
requests 


1 View* 



Issues for Views 


CfM* » n*v» .1 

lu* Advincid Mirch 

Statistic* Cutxcrib* 

Searth for 

Statu* 

Priority Category Vtnton Component 

m i i w [ -*wy* m (m 


(»»<*) 


© Search controls for a module’s issue queue 
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Statistics 




Create a new issue Advanced search 

Statistics Subscribe 


Average lifetime 




Category Overall 

Last month 



bug reports 18 weeks 5 days 

4 days 11 hours 


feature requests 31 weeks S days 

4 days 21 hours 


support requests IS weeks 5 days 

1 week 1 hour 


tasks 24 weeks 5 days 

1 day 23 hours 


Issue activity 




Status 

Overall 

X 

Last month 

active 

574 

6X 

162 

fixed 

93 

1* 

93 

dosed (duplicate) 

10S3 

UK 

48 

postponed 

87 

IK 

7 

closed (won't fix) 

160S 

16* 

23 

closed (works as designed) 

374 

4K 

15 

dosed (fixed) 

5823 

S9X 

14S 

needs review 

132 

IK 

58 

needs work 

90 

IK 

54 

reviewed & tested by the community 

1 

OX 

1 

patch (to be ported) 

27 


17 

postponed (maintainer needs more info) 40 

OK 

35 

closed (cannot reproduce) 

38 

OX 

IS 


O A module’s statistics page 



© Finding all issues related to the 7.x 
version of a module 


Maintained for Views 

mcrlinofchao* - 6721 commit* 
last: IS hours ago, first: 4 years ago 
derein* - 889 commits 
last: 1 day ago, first 49 weeks ago 

dww - 35 commits 

last- ? weeks ago, first 1 year ago 

sun - 21 commits 

last: 1 year ago, first: 2 years ago 

View all committ ers 


Q The link to 
see a list of 
everyone who 
committed code 
to a module 


Some things to look for in the issue 
queue to get a sense of a module’s 
quality: 

► How many outstanding bugs are in 
the version you’re using, as com¬ 
pared to those that have been 
fixed? The drupal.org web site 
conveniently hosts a page of statis¬ 
tics, which you can reach by click¬ 
ing the Statistics link on the issue 
queue page, or by going to drupal. 
org/project/issues/statistics/ 
module-name ©. 

You can look at the bugs themselves 
by going to the issue queue page 
and then setting up a search with the 
Status pop-up menu set to “- Open 
issues -” or “active,” the Category 
pop-up menu set to “bug report,” and 
the Version pop-up menu set to either 
“- 7.x issues -” or the specific version 
you’re using ©. 

► How active is the issues queue? By 
default, the queue appears sorted by 
how recently there’s been discussion 
of issues in the queue. Look down the 
“Last updated” column to get a sense 
of community activity. 

► How often do the module’s main¬ 
tained take part in issue queue 
discussions? Sometimes a developer 
creates a module but then can’t 
afford the time to support it after it 
becomes popular. The result is an 
active issue queue, but nobody’s tak¬ 
ing the lead in getting problems fixed. 

To see who the module’s maintainers 
are, go back to the module’s home page 
at drupal.org/project /module-name 
and click “View all committers” Q. 

(Committers are highly trusted project 

continues on next page 
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contributors who are allowed to incor¬ 
porate changes into the project’s code.) 
This may be a long list: By clicking “Last 
commit” and “Commits” at the top of 
the table, you can sort according to the 
most-recent committers and more-pro¬ 
lific committers, respectively. Then, go 
back to the issue queue at drupal.org/ 
project tissues/module-name, search 
for the committers’ names, and see how 
engaged they are with the community 
that’s using their module. 

3. Another criterion forjudging module 
quality—especially new modules—is the 
reputation of its developers. Click the 
user names of the project’s maintainers 
and its most active contributors to go to 
their drupal.org user profiles 0 A few 
fields are particularly informative: 

► Member for: Tells you how long a 
user has had an account on the 
drupal.org web site. This site is 
essential both for community interac¬ 
tion and learning how to program 
Drupal correctly, so a long-standing 
membership implies (but doesn’t 
guarantee) substantial Drupal 
experience. 

► Projects: Lists other modules and 
themes to which the user has contrib¬ 
uted. The drupal.org site maintains 
this list automatically: It can’t be 
faked. Obviously, an experienced 
developer is likely to have worked on 
more than one project and to have 
committed a substantial number of 
changes to them. 

The profile may also include informa¬ 
tion the user entered by hand, such 
as professional affiliations, interests, 
DrupalCons attended, web sites, and 
availability for custom development 
work. 


KarenS 

Profile Pom 

Contact 

Drupal 

I contributed Drupal modules 
I contributed Drupal documentation 
I provide Drupal-related services 
I attended OSCMS 2007. Sunnyvale 
I attended DrupatCon Barcelona 2007 
I attended DrupalCon Boston 2008 
I attended DrupalCon DC 2009 
I attended DrupalCon Paris 2009 
I attended DrupalCon San Francisco 2010 

Work 

Companies worked Lullabot 
for 

Personal information 

Full name Karen Stevenson 

My Drupal site http://www.elderweb.com 

Country United States 

History 

Member for 4 years 39 weeks 

Projects 

Date (S181 commits) 

Calendar (243S commits) 

Content Construction Kit (CCJQ (1619 commits) 

OC Galleries (142 commits) 

Views Calc (103 commits) 

Views Gallery (72 commits) 

Event (52 commits) 

Pollfield (43 commits) 

Sandbox (37 commits) 

Location (33 commits) 

DruBB (30 commits) 

Switchtheme (28 commits) 

HTML2Book (11 commits) 

Comment Manager (10 commits) 

Custom Contact (10 commits) 

Variable Dump (6 commits) 

Profile Migrate (6 commits) 

Views Bonus Pack (6 commits) 

Flickr (3 commits) 

Embed filter (3 commits) 

Upcoming.org (3 commits) 

Admin (2 commits) 

Views (1 commit) 

Administration theme (1 commit) 

Total: 9837 commits 

0 The user profile of an especially 
active Drupal developer 
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Click the Posts tab to see what discus¬ 
sions the user has participated in, from 
most to least recent. The Contact tab 
lets you send the user a note. (You’ll 
see that tab only if you’re logged in to 
the drupal.org web site and the user 
has enabled it.) However, resist the 
impulse to contact the developer for 
support questions and trivial concerns. 
Chances are you’ll find an answer to 
your questions in the issue queue. 
Leave the developer more time to work 
on modules. 


Drupal's "Hall of Shame" for Duplicated Projects 

Because they’re part of such a wide-ranging and active community, it’s inevitable that Drupal 
module developers will sometimes find themselves duplicating efforts. On one hand, that’s good 
because modules that are similar aren’t exactly the same. Each typically has features and advan¬ 
tages that the other lacks. On the other hand, modules that compete for the same audience run 
the risk of diluting the efforts of both projects. 

That’s the raison d’etre for the Similar Module Review group at http://groups.drupal.org/ 
similar-module-review. As the name implies, it’s intended to identify modules that do essen¬ 
tially the same thing and to help their developers join efforts where possible. Along the same lines 
is the “Comparisons of contributed modules” page at drupal.org/node/266179, which archives 
and organizes many of the discussions from that group and provides tables that clarify how similar 
modules differ from each other. 
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Getting 

(and Giving) Help 


They say an organization reflects the 
personality of its founder. Bill Gates tends 
toward “big system” thinking, so Micro¬ 
soft’s employees follow suit, leading to 
system-minded software; meanwhile, Steve 
Jobs’s emphasis on appearance leads 
Apple products to be fashionable. Success¬ 
ful founders are wise to ally themselves 
with partners of complementary strengths, 
as Jobs did with technical genius Steve 
Wozniak. Without some ability to escape 
the founder’s personality, an organization’s 
audience will always be limited to those 
who are like its founder. 

Drupal founder Dries Buytaert is unques¬ 
tionably a technology-focused person, and 
the Drupal project reflected his personal¬ 
ity through its first six years or so. Since 
2007, he’s seemed to recognize Drupal’s 
yearning to grow beyond its gearheaded 
roots and has aggressively courted busi¬ 
nesspeople, designers, and others whose 
expertise is outside the field of software 
development. But it’s a big ship and turns 
very slowly, so much of Drupal’s existing 
documentation is still developer-centric. 


That’s most obvious on Drupal’s official 
home, the web site drupal.org. Most of the 
discussions are highly technical, and simple 
questions often garner overly technical 
responses. Simply put, there’s a big com¬ 
munication gap between those who are just 
learning Drupal and the Drupal pro commu¬ 
nity that wants to encourage them. 

Fortunately, that gap is closing. A major 
redesign of the drupal.org web site 
launched in October 2010, and the Docu¬ 
mentation Team Lead, Addison Berry 
(drupal.org user name: addlsun), has 
taken pains to encourage more beginner- 
level materials on the site. 

This appendix is a snapshot ofdrupal.org 
and other supporting resources at a given 
moment in time—by the time you read it, 
both the quantity and quality of Drupal 
help will have improved from when I wrote 
it. But some things never change, and 
you’ll always benefit from a constellation 
of group, individual, and packaged help. 
Here’s an overview of all three. 


The Messy Feast 
on drupal.org 

No matter what your Drupal question, 
the response is the same: “You’ll find the 
answer on drupal.org.” That’s true, but 
the site is wildly wide-ranging and pretty 
disorganized. The problem is that it’s a 
community of writers with few editors. Irrel¬ 
evant ramblings have the same weight as 
concise how-tos, and obsolete information 
can remain prominent for years. 

But once you know your way around, it’s 
not all that bad. In particular, four methods 
of navigating the drupal.org site yield 
especially rich results: 

■ Read handbooks. 

■ Search. 

■ Delve into help forums of specific 
projects. 

■ Follow discussion groups for Drupal- 
related interests. 

But before you can take part in discussions 
on the drupal.org site, you must become 
a member of the community by registering 
for an account. (You can read any part of 
the site without an account, though.) 



Q The top of the drupal.org site, showing the 
Login / Register tab 


To create a user account 
on the drupal.org site: 

1. In a web browser, go to drupal.org. 

2. If you’re not already signed in, click the 
Login / Register tab near the top of the 
page ©. 

3. Complete the form on the resulting 
page. 

4. You’ll receive a message at the email 
address you provided, typically within 
a few minutes. If it doesn’t arrive within 
a few hours, try again or use a different 
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Site Building Guide 

► Site builder's toolkit 

► Actions, Triggers, and Workflow 

► Commerce and Advertising 

► Connecting to other Sites, Systems, 
and Data 

► Dates and Events 

► E-Mail and Messaging 
▼ Forms 

o Contact form 

► Form and Interaction Modules 

► Geographic Information 

► Media and Files 

► Search 

► Social Networking and Collaboration 
y User-Generated Content 

► HowTos 

► Site recipes 

The Drupal handbook pages are © 2000-2010 
by the individual contributors and can be used 
in accordance with the Creative Commons 
License, Attribution-ShareAlike 2.0. PHP code 
is distributed under the GNU General Public 
License 


© A block for the Site Building Guide, as it 
appears while viewing the Forms page 


email address, as it’s possible that your 
mail-service provider blocked it. 

Follow instructions in that message to 
change your password from the tempo¬ 
rary one that drupal.org provided to 
one you’ll remember. 

You now have an account on the 
drupal.org web site. Be sure to log in 
to it whenever you want to take part in 
discussions there. 

To get basic help via handbooks: 

Site administrators for drupal.org use the 
term handbook somewhat loosely to mean 
“a collection of content packaged together 
using Drupal’s Book module.” As you might 
remember from the “Creating Other Types 
of Content” section of Chapter 3, the Book 
module links related nodes of information 
in a (somewhat) easy-to-navigate structure. 
It’s an advantage over haphazardly linked 
nodes, especially on the drupal.org site 
where handbooks can run into dozens or 
even hundreds of pages. 

To reach the main portal for Drupal hand¬ 
books, click the Documentation link at the 
top of any page on the drupal.org site 
(when logged in) or go directly to drupal. 
org/handbook. When you start reading 
a handbook, a block appears in the right 
column of the page that shows all pages 
within that handbook ©. Links with small 
arrows next to them indicate pages that 
contain child pages with further, related 
instructions. (The bottom of each hand¬ 
book page also lists its child pages.) 

One final note: If you’re having a problem, 
read the Troubleshooting FAQ at drupal. 
org/Troubleshooting-FAO before going 
further. It’s full of tips that will help you 
either solve the problem yourself or diag¬ 
nose it well enough to talk about it clearly. 
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Search Drupal.org 


To search drupal.org: 

The simple appearance of the search box 
in drupal.org’s upper-right corner belies 
some remarkable powers ©. Specifically, 
drupal.org has what’s called a faceted 
search, allowing you to narrow the results 
list in a convenient way. 

The first step is obvious: Enter text into the 
search box and click the Search button. 

The resulting page resembles google.com. 
Having searched through a million or so 
nodes, it returns with titles, brief excerpts, 
and other information from search hits ©. 

If you don’t immediately see what you 
want, don’t give up! drupal.org’s search 
lets you go further in two ways: 

1. The links labeled IRC Nicks, Users, and 
Advanced Issues in the right column 
immediately perform your search in 
those spaces G. (The first page of hits 
lists only nodes.) 

So let’s say you get help from some¬ 
one in IRC who goes by the nickname 
“tha_sun.” Perform a search for that, 
then click the IRC Nicks link. You quickly 
learn that you were gifted with the wis¬ 
dom of none other than the drupal.org 
user sun, or (as one further click on the 
name tells you) Daniel F. Kudwien. 

2. The other links on the right side of the 
page let you limit your search results 
by several criteria. The numbers next to 
each link indicate how many hits will be 
left after you click. Click any of the links 
in the “or filter by...” block to narrow 
your selection. To remove a facet and 
return to the previously found set, click 
the All link at the top of the block. 


Search 


• Modules 

• Themes 

• Documentation 

• Forums & Issues 

• Groups 


©The main search box on drupal.org 



O The result of a simple search 


Search again 



or filter by... 

<1I B»W3 1 

Modules (1607) 

Themes (65) 
Documentation (1790) 
Forums & Issues (127733) 
Croups (17) 

or search for... 

IRC Nicks 
Users 

Advanced Issues 


© Blocks on the 
search results 
page that let you 
narrow your search 
or perform it in a 
different data space 
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Download & Extend 

Dnwnlnad A Fxtand Horn? Drupal Core Modules 
Rules » Issue s 

Node Reference from the URL 

Posted by Parkas Design on September fi, ?009 At 11 Plpm 

Q Clicking the last item in the bread¬ 
crumb trail takes you to the node’s 
parent area 


GD To search for a phrase, enclose it in 
quotation marks. If you don’t include them, a 
search for node reference will, for example, 
find nodes that contains the words “node” 
and “reference,” even when separated by 
several sentences, rather than the term “node 
reference.” 

GD The site groups.drupal.org is 
intended for subject-related discussions, for 
example to help people build real-estate sites 
with Drupal or to integrate mapping soft¬ 
ware. It’s an incredibly useful resource but is 
unfortunately separate from drupal.org, so a 
search on one doesn’t see items on the other. 

I definitely recommend searching on both, 
particularly if your issue is subject-specific. (At 
the time I write this, there are plans to better 
integrate the two sites.) 

GD Many people find it simpler to search 
the drupal.org site through the search 
engine they usually use. On google.com, 
for example, you’d search for “node refer¬ 
ence” by entering siterdrupal.org "node 
reference" in Google’s search box. You could 
further search within a specific project by 
changing the site: parameter. For example, 
the same search within the CCK module 
project’s pages would be siterdrupal.org/ 
project/CCK "node reference". 

GD Sometimes you’ll click a search result 
and find yourself deep in the bowels of a proj¬ 
ect about which you want more general infor¬ 
mation. Links in the breadcrumb trail above 
the node’s title give you a broader view. Q 
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To ask questions: 

So you’ve searched the drupal.org web 
site and not found a satisfactory answer. 
You’ve looked through the Troubleshooting 
FAQ at drupal.org/Troubleshooting-FAQ 
and feel confident that you haven’t 
overlooked something obvious. Now it’s 
time to ask your question directly in the 
appropriate forum. The bad news is that it’s 
sometimes hard to determine which forum 
is most appropriate; the good news is that 
a well-placed question on drupal.org is 
part of the site’s permanent record, with 
the potential to help everyone who follows 
you. So don’t hesitate to ask. 

But be prepared to wait for a response— 
and for some of the answers to be less 
useful than you’d like. Remember that 
everyone on drupal.org is there as a 
volunteer, on their own free time: Every 
response, even the ones that are snotty 
or wrong, represents some effort. With 
that in mind, here are some tips for asking 
questions: 

■ If it’s a basic, general question, con¬ 
sider posting in the main forum area at 
drupal.org/forum. However, don’t post 
in the forums labeled “deprecated.” 
They’re no longer actively used. They 
remain visible on the site only as an 
archive. 

■ Search for a similar question that has 
gotten good responses, and post in that 
discussion area. 

■ Post in a way that fits in with the rest of 
the drupal.org site, as is outlined in 
the sidebar “Discussion Etiquette.” 


To get help for specific 
modules and themes: 

Most of the advice in the “To ask ques¬ 
tions” section is true for finding help for 
specific modules and themes. But rather 
than starting with the search box, I’d 
recommend first going to the project’s 
home page at drupal.org/project/ 
module-name and clicking the relevant links 
(such as “Read documentation”) in the right 
column of that page, or searching that proj¬ 
ect’s issue queue. To learn how to navigate 
the issue queue better, see the section “To 
evaluate a module’s past” in Chapter 9, 
“Extending Drupal with Modules.” 
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Discussion Etiquette 

Every society has its standards, and the one that’s grown up around Drupal is no different. Many of 

its social expectations are common to the society at large (be polite), some are common to techni¬ 
cal groups (be concise), and some are Drupal-specific (know who the major developers are). Here’s 

a list of some of the most important points. 

■ Include the meat of the question in the title. Writing good headlines is a difficult but profitable 
art: “Can’t edit newly created book page” will get more (and better) help than “Please help me.” 

■ Post in only one place at a time. Posting in multiple forums, also known as cross posting, might 
result in a faster response. But it’s considered spam and is such an antisocial practice that 
knowledgeable Drupal experts may ignore your questions out of spite once they discover your 
bad behavior. 

But what if you posted in an inappropriate place, and therefore didn’t get any responses? If you 
posted an issue, anyone (including you) can change where it’s posted by changing the informa¬ 
tion in the “Edit issue settings” section. Otherwise, it’s reasonable to post a second time in a 
more appropriate forum after a fair amount of time has gone by—say, a few days. When you do, 
include a link back to the original issue, and then put a note in your first post directing people 
to the second one. 

■ Resist the temptation to contact developers directly. It’s the most natural belief in the world: A 
project’s creator is the person most knowledgeable about how it works, right? So they should 
be able to quickly answer your question! But the reality is quite different: Knowing how some¬ 
thing works isn’t the same as knowing how it’s used. More importantly, a project’s developer is 
often overwhelmed with requests and can focus only on those that help the most people—for 
example, fixing bugs or adding features. So chances are you’ll get silence rather than the quick 
help you need. 

■ Provide details. Include the version of Drupal you’re using; the version of relevant modules and 
themes; details of changes you made to your site before encountering problems; and, most 
importantly, how to reproduce the issue. (I try to include numbered steps in every issue I post.) 

■ Report back. If you discover something that affects the issue, post a comment to that effect. 
And if you end up solving the problem yourself, write to tell everyone how you did it. Chances 
are good that others will be waiting for that information—or that someone will find the discus¬ 
sion months later and be glad that you gave it closure. 

■ Give back. Look through the discussions at drupal.org/forum once in a while. When you 
see a question you can answer, do so! Another place you’ll find people in need is in the issue 
queues of specific projects. Just go to drupal.org/project/issues/project-nome, choose 
“Open issues” from the Status pop-up menu and “Support request” from the Category pop-up 
menu, and click Search. 
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Getting One-on-One 
Help on IRC 

The Drupal community has a secret back 
room for getting immediate help: channels 
on the real-time Internet Relay Chat system 
hosted at irc.freenode.net. In truth, 
it’s not a secret chat system, and in fact 
there’s a page of step-by-step instructions 
for using it at drupal.org/irc, advertised 
prominently on drupal.org’s support page 
at drupal.org/support. 

But IRC (usually) requires you to use 
an unfamiliar program and learn some 
obscure commands, so few people who 
aren’t hard-core technologists use it. On 
one hand that’s unfortunate, because IRC’s 
technical complexity freezes some people 
out; on the other, it means that IRC chan¬ 
nels are generally populated by dedicated 
people with a high level of technical 
knowledge. 

The fastest way to get into Drupai IRC 
chats is to log on via a web-based inter¬ 
face, such as the one at http://webchat. 
freenode.net ©. Enter a user name and 
the channels you want to join, and solve 
the CAPTCHA challenge. In the Channels 
field, type channel names separated with 
a comma and no space; many are listed 
at drupal.org/irc. Click Connect, and 
you’re in! 

Upon connecting, you see a window with a 
main chat area and a few other features ©: 

■ In the page’s upper-left corner is an icon 
that looks like &▼. Clicking it gives you 
a pop-up menu with options that let you 
change certain settings (such as the 
background color) and lead to further 
information about the IRC program. 



© Connecting to two Drupal IRC 
channels via a web-based interface at 

http://webchat.freenode.net 



©An IRC session on the #drupal-support 
channel. 
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■ Immediately to the right of the icon 
are tabs that show which channels 
you’ve joined—in ©, that’s #drupal 
and #drupal-support— along with a 
tab for the Status window that shows 
connection messages as people enter 
and leave the chat channel. The tab for 
the currently visible channel appears 

in white, while the others have the 
background color. To switch to another 
channel, click its tab; to leave a channel, 
click the x on its tab. 

■ In a non-scrolling area above the main 
chat are messages about the currently 
visible channel. Pay attention: This area 
often contains valuable information for 
newcomers. 

■ The area to the right shows a list of 
everybody currently in the channel. 
Clicking a name gives you the option 
to find out more about that person 
(“whois”) or to talk directly to that per¬ 
son (“query”). When you query some¬ 
one, a new tab appears to show that 
you’ve opened a private channel with 
that user. Use this feature sparingly. 

For better control over IRC sessions, down¬ 
load and use a dedicated IRC client. Some 

popular free clients are: 

■ Mac: Colloquy at colloquy.info 

■ Windows: Miranda at miranda-im.org 

■ Any computer running the Firefox 
browser: ChatZilla at http:// 
chatzilla.hacksrus.com 


GD Definitely read the tips at drupal.org/ 
ire before venturing on. That page contains 
some extremely useful aspects of IRC that 
wouldn’t fit here, such as registering your 
nickname and getting automatic help from 
the IRC robot. 

(ZD Despite its name, the #drupal channel 
is not for general support chat. Rather, it’s 
for developers of core Drupal, modules, and 
themes, and for business related to maintain¬ 
ing Drupal projects. Some support questions 
are tolerated, particularly if related to using 
the Drupal API, but Drupal administration 
questions usually get ignored. 

(ZD The #drupal-support channel is the 
best place to ask general questions, unless 
a more specific forum exists (for example, 
#drupal-views or ttdrupal-themes). A list 
of many other channels is at drupal.org/ 
ire. 

(ZD New channels often appear during Dru¬ 
pal conferences and can provide an important 
“back channel” venue for chatter during the 
sessions. Even if you can’t attend a Drupal- 
Con, you can still listen in on #drupalcon dur¬ 
ing the event. Read the event’s promotional 
materials for other conference channel names. 

(ZD As in drupal.org forum discussions, 
everybody taking part is a volunteer. They’re 
not getting paid to answer your questions and 
are under no obligation to do so. Often, ques¬ 
tions simply don’t get an answer. That’s the 
way it is. One way to get more help is to offer 
it yourself. Helpful people recognize and honor 
one of their own. 
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Hiring Drupal Experts 

They say that “volunteer work is worth 
every penny you paid.” While that’s overly 
cynical—the Drupal project itself is the 
result of expert, painstaking, nearly all¬ 
volunteer labor—it is true that being on 
the payroll increases motivation. When 
you pay, you can direct efforts, specify 
(and enforce) deadlines, and ensure that 
the less-fun parts of the job get done. As 
a parody version of the Golden Rule says, 
“Thems with the gold makes the rules.” 

But how do you know whom to hire? 
Drupal is still young and obscure enough 
as a technology that there are no widely 
accepted certifications, no competency 
tests, and very few standards. You 
shouldn’t expect any to appear soon, 
either, as ongoing discussions show that 
Drupal consultants take a dim view of 
standardized competency testing. At the 
same time, there are criteria that will tell 
you whether a Drupal consultant has what 
it takes. 
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Projects 

Pathauto (701 commits) 

Comment Notify (220 commits) 
Token (124 commits) 

S5 presentation player (80 commits) 
Hyperlocal News (55 commits) 
Prediction Markets (41 commits) 

© The bottom part of a profile on the drupal. 
org web site, showing how many times the user 
committed code to various projects 


To find clues from looking at 
a user's drupal.org account: 

Drupal’s history is intimately connected to 
its community on the drupal.org web site, 
which has been in active use since 2002. it 
tracks and makes public its users’ activities, 
creating a record that helps you determine 
whether someone’s experience is sufficient 
and relevant for your job. Here are some 
particularly informative nuggets of data 
from that record. 

■ Length of time with a drupal.org 
account. The drupal.org web site is by 
far the most central source for informa¬ 
tion, education, and community for Dru¬ 
pal. While someone without an account 
could read texts and download soft¬ 
ware from the site, that person would 
be unable to take part in discussions or 
contribute code—two central facets of 
learning. 

To find out how long someone’s had 
a drupal.org account, search for the 
user name with the techniques you 
learned in the “To search drupal.org” 
section, or go directly to drupal.org/ 
search/user_search/user-n<7me. Click 
the user name, then scroll to the History 
section at the bottom. 

■ Other information on the drupal.org 
profile, which includes a list of involve¬ 
ment with the Drupal community 
(through conferences, code contribu¬ 
tions, and so forth) and companies 
worked for. 

The drupal.org site automatically 
keeps track of how many times that 
user “committed” code to a project on 
the site—that is, made it an official part 
of the project ©. 

continues on next page 
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Keep in mind that people sometimes 
contribute substantially to a project 
without ever committing code, for 
example by testing, writing documenta¬ 
tion, working through issues in forum 
discussions, offering assistance via 
email or IRC, or contributing money. 
Also, someone can contribute code 
without having the ability to commit it. 

(I personally don’t have any commits 
to my name, although I’ve contributed 
minor patches.) Having said all that, a 
high commit count usually indicates 
impressive levels of open-source 
programming activity and trust among 
project maintainers. 


Drupal-based sites that the user has 
created. Profiles on drupal.org have 
only one space for “My Drupal site,” and 
most people typically put the address of 
their blog there. However, other parts of 
the profile might contain clues leading 
to Drupal-based sites the user created. 

Activity on the drupal.org site itself. 
When viewing someone’s profile, click 
the Posts link to see details on discus¬ 
sions the user has taken part in ©. 
Clicking any of the items leads you to 
the content itself, where you’ll see how 
the user interacts with colleagues on 
the site. (A “Commits” tab also appears 
on the profiles of users who have com¬ 
mitted code to a Drupal project.) 


add1sun 




Profile 

Posts Commits 




Typ« 

Post 

Author 

Replies 

Last updated 

Issue 

Forms API & other big array documentation new 

mertinofehaos 

60 

2 new 

6 hours 27 min 

ago 

Issue 

Delay in load when hovering new 

karensmallwood 

3 

3 new 

1 day 2 hours 
ago 

Issue 

Review and update the Installation guide updated 

add1sun 

74 

1 new 

1 day 2 hours 
ago 

Issue 

Move events handbook to Cetting Involved new 

add1sun 

S 

2 new 

1 day 9 hours 
ago 

Project 

Prepopulare new 

jbrauer 

0 

1 day 10 hours 
ago 


© The Posts page for a particularly active drupal.org user’s account, showing discussions 
she’s participated in 
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To find clues from other sources: 


Let’s say your detective work on the 
drupal.org site narrowed the search down 
to a few likely candidates, and you’ve con¬ 
tacted them by clicking the Contact tab on 
their profiles. (Not all users have a Contact 
tab, as they can turn it off if they prefer.) 
How else can you judge their abilities 
before you hire them? Consider both tech¬ 
nical and non-technicai criteria, including: 

■ Availability. A perfect consultant with no 
time for your project is the same as no 
consultant at all. 

■ Appropriateness. Module development, 
site building, site maintenance, docu¬ 
mentation, and theme design all require 
different skills, which don’t always 
overlap. (People who are good at both 
programming and design are particu¬ 
larly rare.) There are subspecialties 
even within these specialties, so some¬ 
one who’s created a great e-commerce 
module probably doesn’t know much 
about modules for graphic manipula¬ 
tion. Hire right. 

■ Reputation. So your “perfect” candi¬ 
dates worked on some beautiful sites. 
But did they meet deadlines? Were 
they easy to work with? Did they leave 
important tasks for others to do? The 
only way to uncover these hidden 
competences (or incompetences) is to 
talk with those who worked with them. 
Request contact information and follow 
up. Keep in mind that consultants will 
only refer you to contacts they think will 
give them a good recommendation. If 
you can reach any other people who 
worked with them, all the better. 

continues on next page 
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■ Ability to communicate. “The whole is 
greater than the sum of its parts”—but 
only when those parts work together. 

If consultants seem to have trouble 
understanding your project or their 
part in it, don’t hire them. You might 
find that they excellently perform the 
wrong tasks. 

Finally, consider the tips in the article “Hir¬ 
ing a Drupal site developer” (drupal.org/ 
node/51169). 


It Goes Both Ways: Finding Drupal-Related Work 

As I write this, unemployment in the United States is around 10 percent—nearly double the aver¬ 
age during the 1990s. But Drupal is a growth industry, with more contracts than people to fill them. 
So how can you get a piece of this action? 

First, realize that most Drupal jobs require advanced knowledge far beyond what’s taught 
in this book. Judging from the want ads, Drupal-capable PHP programmers seem to have 
their pick of work, followed by themers and site builders. But there is work for those with only 
fundamental skills. 

The first place to look is in the jobs board at http://groups.drupal.org/jobs. This page aggre¬ 
gates jobs posted in the many regional and topic-specific discussion groups on http://groups. 
drupal.org. Pop-up menus let you narrow your search by various criteria; clicking a link in the 
Groups column takes you to that group’s home page, which includes posts both related and unre¬ 
lated to jobs. 

Beyond the drupal.org and groups.drupal.org sphere, many employers list their Drupal-related 
jobs in job-bank sites such as monster.com and careerbuilder.com. A search for Drupal on 
those sites quickly finds them. (As I write this, that search returns about 120 jobs on each site. The 
same search a year ago—in late 2009—netted 65.) 

But if you’re serious about making Drupal your career, your best bet is to first demonstrate your 
value, then let it shine. Take part in discussions on the drupal.org sites; provide support on IRC; 
most importantly, go to face-to-face Drupal meetings. In the Drupalsphere, as in the world at 
large, most hires happen among existing friends and colleagues. Prove your worth and the work 
will come. 
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Giving Back 

Drupal’s commercial outlook is bright, partly 
because Drupal is the right software at 
the right time. But Drupal business stands 
on the shoulders of the non-commercial, 
volunteer support provided by thousands 
of people. The need for community support 
is ongoing and ensures the future of Drupal 
in every context. Without it, your Drupal 
skills (and mine) could become irrelevant 
as other, better-supported technologies 
overtake it. 

That reason alone compels us all to pro¬ 
vide support to Drupal community projects, 
but there are two far more selfish reasons. 
First, in figuring out the solutions to others’ 
problems you learn at least as much as the 
person you’re helping; second, by sup¬ 
porting Drupal you become better known 
among those who will eventually support 
your own efforts. 

The page at drupal.org/contribute gives 
details on how to help in the areas of: 

■ User support 

■ Documentation and translation 

■ Usability, graphic design, and theming 

■ Development of modules and core 
Drupal 

■ Marketing 

I’ve organized ways for giving back to Dru¬ 
pal into two larger groups: technical and 
non-technical support. 
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To provide non-technical support: 

■ Respond to questions in the Support 
forums at drupal.org/forum. 

■ Respond to questions on the Support 
email list, after first joining at http:// 
lists.drupal.org/listinfo/support, 

■ Respond to real-time questions on the 
#drupal-support IRC channel. (See 
the section “Getting One-on-One Help 
on IRC" to learn how to use this chat 
venue.) 

■ Help solve problems in the issue data¬ 
base at drupal.org/project/issues. 

(For tips on navigating this database, 
see the section “To evaluate a module’s 
past” in Chapter 9.) 

■ Create or (better yet) improve docu¬ 
mentation, using links found at drupal. 
org/contribute/documentation. In my 
opinion, Drupal’s core documentation 
needs editing and organization more 
than it needs new materials: If you have 
a librarian’s mind, go for it. Modules and 
themes, on the other hand, often have 
no documentation other than the brief 
notes provided by their developers, 
and benefit from the input of creative 
educational writers. 

■ Translate modules and core Drupal. 

If you speak a language other than 
English, the Drupal project needs you! 
Core Drupal 6 was available in over 50 
languages (including my own obscure 
second language, Esperanto), and each 
one was the result of the efforts of 
polyglots like yourself. See drupal.org/ 
contribute/translations to learn 
how you can help. 


Identify issues in modules, themes, and 
core Drupal. Even if you can’t develop 
solutions, uncovering and document¬ 
ing issues you come across is the first 
step to fixes. When you find something 
wrong, create an issue that clearly 
states the problem, documenting all 
the steps necessary to reproduce it. 

To do so, navigate through the appro¬ 
priate issue database as you learned 
in the section “To evaluate a module’s 
past” in Chapter 9, search to ensure 
that the issue hasn’t been reported 
already, click “Create a new issue,” and 
complete the resulting form. There are 
further details on the “Helping with Test¬ 
ing” page at drupal.org/contribute/ 
testing. 

Spread the word, if you have an evan¬ 
gelical bent, encourage Drupal’s growth 
with help from the resources at drupal. 
org/contribute/marketing. 

Donate money to the Drupal Foun¬ 
dation, a not-for-profit organization 
created to pay for such matters as 
event management and comput¬ 
ers to host the drupal.org web 
site. The group’s home page is at 
http://association.drupal.org. 

Sponsor module development. Is there 
a module you wish were better? Con¬ 
tact its maintainers (using techniques 
you learned in Chapter 9) and offer to 
pay for their time to work on it. Often 
module weaknesses are the result of 
simple economics: Their developers 
need to make a living, and module 
development doesn’t pay anything. 

By paying for their time to work on the 
module, you create improvements that 
directly benefit every Drupal administra¬ 
tor that uses it. 
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To provide technical support: 

Although the Drupal community is heavy 
with programmers, there’s always room 
for more—especially if you’re willing to do 
some of the hard, under-recognized work 
that makes existing code stronger. Here 
are some ways to do that. 

■ Familiarize yourself with Drupal’s 
development resources at drupal.org/ 
contribute/development. 

■ Learn how Drupal’s API and central 
code repository works. Drupal has 
some unique programming patterns, 
and the multi-user system for contribut¬ 
ing code presents its own challenges. 
Doing things “the Drupal way” ensures 
that any code you create will meld 
well with that of its thousands of other 
contributors. Besides the drupal.org/ 
contribute/development resource, 
http://api.drupal.org will serve 

you well. 

■ Fix bugs in the issue database. As 
always, you can search through the 
entire database by pointing a web 
browser at drupal.org/project/ 
issues, or focus only on specific proj¬ 
ects at drupal.org/project/issues/ 
project-name. 

■ Help test others’ fixes. Every code 
fix (known as a patch) goes through 
several steps, from attempted fix to 
committed code. An automated testing 
system ensures that the patch works— 
that is, that it doesn’t cause problems. 
But human interaction is needed to 
make sure the patch does what’s 
expected. Learn how to help with this 
important step by reading drupal.org/ 
contribute/testing. 
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Face-to-Face with the 
Drupal Community 

It’s easy to feel lonely in your Drupal pur¬ 
suits, especially if you aren’t already com¬ 
fortable in the disembodied world in which 
software geeks live. Fortunately, the Drupal 
community is now large enough to host 
hundreds of face-to-face meetings a year. 

All such events appear on the calendar at 
http://groups.drupal.org/events. Some 
of them are linked to groups on the http:// 
groups.drupal.org site. If that’s true of an 
event you’re interested in, click to go to the 
group that’s sponsoring (or at least discuss¬ 
ing) the event. 

There are essentially four types of face-to- 
face meeting: 

■ Drupal User Groups (DUGs) often have 
regular meetings that feature speak¬ 
ers, discussions, and hands-on help. 
They tend to attract a core group of 
experienced Drupal enthusiasts but 
are extremely welcoming to new and 
inexperienced users. 

■ DrupalCamps are special events, 
usually sponsored by a local DUG or 
Drupal-focused business. Typically, 
they’re one day long, free (or low cost), 
and have sessions geared toward both 
new and experienced Drupal users. 

■ DrupalCons occur twice a year: in the 
spring in the U.S., and elsewhere (tradi¬ 
tionally Europe) in the autumn. Spon¬ 
sored by the Drupal Association, these 
are must-attend events for Drupal pro¬ 
fessionals and developers. They feature 


talks, special-interest group meetings, 
exhibits, and social get-togethers over 
a four-day period. Information about the 
next DrupalCon is at drupalcon.org. 

■ Drupal classes are held by various 
Drupal experts and training companies. 
They tend to be highly focused events 
of a day or more, held in a classroom- 
style setting, for “corporate” (that is, 
comparatively high) prices. 
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Glossary 


Drupal Terms 
and Culture 


Drupal isn’t only a software package. It’s 
also a community of computer profession¬ 
als, hobbyists, students, and just plain folks 
who have shepherded it since its origin 
in 2001. 

Like any community, it has its jargon 
and peculiar way of doing things. Some 
terms and practices are opaque to all 
but professional-level programmers and 
administrators—Drupal’s family of origin. 

As the project continues to grow, it 
attracts more and more people who don’t 
have a background in computer sci¬ 
ence, a fact that’s caused some conflict 
within the community itself. One sign of 
disorder is evident from browsing the 


official documentation on drupal.org. 
What words does it explain? What Drupal 
standards are non-obvious? Who, exactly, 
constitutes Drupal’s audience? 

Overall, the Drupal community is a wel¬ 
coming and helpful one, as is evident from 
the thousands of person-hours its mem¬ 
bers contribute every day to make Drupal 
clearer and easier to use. But definitions 
of its jargon and culture are scattered 
among drupal.org’s half a million pages. 
The following terms are defined in a Drupal 
context to give you the foundation you 
need in order to follow—and participate 
in—community conversations. 


Acquia Drupal: A version of Drupal com¬ 
prising core Drupal with several additional 
modules and themes. Commercial sup¬ 
port for it is available from Acquia, Inc. 
(acquia.com), a company co-founded by 
Drupal’s original creator, Dries Buytaert. 

administrator: This word has two 
meanings: 

1. A person who manages a Drupal site. 

2. One of the user roles that come built 
in to Drupal in its default installa¬ 
tion. (The other two are anonymous 
user and authenticated user.) The 
administrator role automatically gains 
permission to use and manage fea¬ 
tures of new modules that you install. 

anonymous user: The role given to site 
visitors who have not logged in to a user 
account. Such visitors have no profiles, 
user names, or signatures. As an admin¬ 
istrator, you control how much access 
anonymous users have by setting controls 
on the permissions screen. (To reach it, 
click People in the Toolbar and then click 
the Permissions tab.) 

authenticated user: The role automati¬ 
cally given to site visitors who have logged 
in to a user account. Such people have 
individual identities (in the form of profiles), 
and they’re identified as the source for 
any content they create. An authenticated 
user may have other roles, including the 
administrator role. 

block: Content that can be placed in any 
of a theme’s block regions. A block can 
contain many kinds of content: static or 
dynamic; created by a module, an admin¬ 
istrator, or Drupal itself; resulting from a 
script; or fed from another web site. You 
add, modify, and delete blocks on the 
Blocks administration page; to go there, 


click Structure in the Toolbar and then click 
Blocks. 

block region: A part of the screen where 
you can place blocks. Drupal requires that 
themes have one block region, the “con¬ 
tent” region, where node content appears 
by default. However, most themes have at 
least a header, a footer, and two sidebars, 
while some themes have many more block 
regions. (The default Bartik theme has 
15.) You can see a map of a theme’s block 
regions by going to its settings page and 
clicking “Demonstrate block regions.” 

code: Instructions in a language that com¬ 
puters understand. Most Drupal code is 
written in PHP, although JavaScript is also 
common and other languages are possible. 
While instructions in descriptive languages 
such as CSS and HTML are technically 
code, the term is usually reserved for lan¬ 
guages that define steps to a goal. 

comment: Content that’s attached to a 
node, usually created in response to it. 

committer: Someone with permission to 
put project changes into Drupal’s official 
code repository on drupal.org. 

content type: A pattern for making nodes. 
Content types differ in their settings and 
the fields they contain. Drupal comes with 
two content types enabled by default: 
article and basic page. You can cre¬ 
ate additional content types by clicking 
Structure in the Toolbar and then clicking 
“Content types.” 

contributor: Someone who works on a Dru¬ 
pal project, whether as a developer or in 
another capacity—for example, by provid¬ 
ing documentation. 

contrib: Short for “contributed.” Refers to 
Drupal-compatible projects— particularly 
themes and modules— that are freely avail¬ 
able, but not part of core Drupal. 
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core Drupal: The main, “official” form 
of Drupal available for download at 
drupal.org. Because Drupal is open- 
source software, anybody could legally put 
together a distribution that mixes pieces of 
Drupal with other software. By comparison, 
every piece in core Drupal goes through 
a unified development and review system 
overseen by Dries Buytoert and his volun¬ 
teer deputies. 

dashboard: An administrative page show¬ 
ing recent site activity and useful controls. 
The dashboard is highly customizable. See 
“To customize the Dashboard” in Chapter 2 
for details. 

developer: Someone who creates Drupal- 
compatible code, whether as a contributor 
to a project or core Drupal, or in service of 
an individual Drupal site. 

distribution: A version of core Drupal that 
excludes some of its pieces, includes addi¬ 
tional pieces, or has installation or configu¬ 
ration features that differ from core Drupal. 
One example is CiviCRM (civicrm.org), 
which is designed for online management 
of organizations such as non-profit and 
advocacy groups. 

Dries Buytaert: 

Drupal’s original 
creator and the 
trademark holder 
for its name ©. 

He started writing 
Drupal in 2000 
while a student at the © Dries Buytaert 
University of Antwerp 
(Belgium), releasing it as open-source 
software in 2001. He still maintains close 
ties to the Drupal community, contributing 
and managing its code, serving as a board 
member of Drupal Association, and 
delivering a “State of Drupal” address at 
each semi-annual DrupalCon. 


Drupal: A free and open-source software 
package that works with a web server 
(such as Apache), a database server (such 
as MySQL), and the PHP scripting language 
to develop and deliver web sites. Its name 
is the result of an error. Dries Buytaert 
originally intended to register the domain 
dorp.org to host the project, after the 
Flemish word for village. But he mistyped 
the application as drop.org and later 
named the software Drupal after “drup- 
pel,” the word for “little drop.” Drupal is 
pronounced DROO-pl or (less frequently) 
DROO-pahl. 

Drupal Association: A Belgium-based not- 
for-profit organization founded in 2006 to 
“provide support to the Drupal project.” 

DrupalCon: A meeting of Drupal profes¬ 
sionals and fans occurring twice a year, 
typically as a spring event in the United 
States and a smaller European gathering 
in autumn. The event has grown steadily, 
with the April 2010 event in San Francisco 
drawing over 3000 people. (The August 
2010 European DrupalCon in Copenhagen 
drew over 1200.) 

Druplicon: The Drupal 
project’s mascot, which 
looks like a drop of water 
with a face ©. It plays 
on the project’s original © The 

domain name, drop.org. Druplicon 

entity: A kind of information container 
that can contain fields. Nodes, profiles, 
taxonomy terms, and comments are all 
examples of entities in Drupal 7. 
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field: A space for information stored in 
Drupal’s database. You can add fields to 
entities such as content types, after which 
every node of that content type contains 
that field. For example, you might design 
a content type to organize the books in a 
public library, where each book is a node 
of the content type volume. That content 
type could have a field for each book’s 
catalog number, another field that says 
whether the book is fiction or nonfiction, 
and so forth. An example of a field you 
might add to profiles is one for phone 
numbers. 

maintainer: The chief decision-maker of a 
project. The maintainer is usually one of 
the project’s most active developers and 
is always a noted contributor. The name 
of a project’s 
maintainer is 
given at the 
upper-left 
corner of the 

project s home Q a link to the profile of a 
page @. project’s maintainer. 

module: A software package that adds func¬ 
tionality to Drupal. Hundreds of such pack¬ 
ages are available for free at drupal.org/ 
project/modules. For details on how to 
select and install modules, see Chapter 9, 
“Extending Drupal with Modules.” 

node: The basic unit of content in Drupal, 
such as an article, basic page, poll, or blog 
post. You create nodes by clicking “Add 
new content.” In virtually all themes, node 
content appears in the center of the page, 
in the content block region. 

permissions: Controls on a Drupal site that 
allow users to have different access levels 
to site features, based on their roles. You 
control permissions by clicking People in 
the Toolbar and then clicking the Permis¬ 
sions tab. 


profile: A place for details about an authen¬ 
ticated user on a Drupal site. By default, 
profiles are hidden from everybody except 
the superuser and those users with the 
administrator role, and contain only such 
basic administrative matters as a user’s 
user name, email address, and time zone. 
By enabling more-liberal permissions and 
adding profile fields, you can use profiles 
as a way for your site’s users to better 
understand and interact with each other. 

project: Themes, modules, transla¬ 
tions, and other community-managed 
software found at drupal.org/project/ 
project-name —including Drupal itself. 

role: A categorization for users. All visitors 
to your site who haven’t logged in have 
the anonymous user role; those who have 
logged in have the authenticated user 
role, and may have additional roles as well. 
You assign permissions based on role, so 
all users with a specific role have the same 
permissions. 

Shortcut bar: A collection of administrative 
links displayed in a gray strip just below 
the Toolbar. You can add and remove 
links to it: See the section “To change 
which items appear in the Shortcut bar” in 
Chapter 2. 

superuser: The user that’s created when 
you first install Drupal. This user has abso¬ 
lute access to all content and administra¬ 
tive functions on the site. The superuser 
is sometimes known as User ID 1, being 
the first user on the system. Because 
superuser is a commonly used term in 
other computer science contexts, some 
Drupal documentation contributors prefer 
the more-specific term “site maintenance 
account.” 


Pathauto 

KFW CVS instruction t Revisions 

Potted by oreoc^ s on ftbcutry 14. iOOi it t.Obpm 

The Pathauto module automatical^ generates path 
for various kinds of content (nodes, categories, use 
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taxonomy: A system of categorization. 
Drupal lets you categorize content, where 
each type of categorization is known as a 
vocabulary and each label is a term. Col¬ 
lectively, this system is a site’s taxonomy. 
For better understanding, see Chapter 5, 
“Making Content Interactive.” 

template: A PHP file that’s part of a Drupal 
theme, which defines the kind of infor¬ 
mation that appears at different places 
throughout your site. (The theme’s CSS 
files define the format of that information.) 
For further details about templates, see the 
“Core templates and suggestions” page at 
drupal.org/node/ 190815 . 

term: Part of Drupal’s system of catego¬ 
rization, a term is a specific selection in 
a category. Terms belong to vocabular¬ 
ies that define the kind of category. For 
example, you might categorize cars by 
the kind of transmissions they have: The 
vocabulary would be “transmission type,” 
which would contain the terms “automatic” 
and “manual.” 

theme: A package of PHP, CSS, image, and 
other files that defines your Drupal site’s 
look and feel. Drupal 7 comes with four 
themes, and drupal.org/project/thernes 
offers dozens more as free downloads. You 
can also create your own themes or buy 
them from commercial vendors. Drupal’s 
default content theme is Bartik, while its 
default administration theme is Seven. To 
select and configure your site’s theme, 
click Appearance in the Toolbar. A person 
who creates Drupal themes is called a 
“themer.” 

Toolbar: The black strip of administra¬ 
tive links you see at the top of your web 
browser’s window when you’re logged into 
a Drupal site as an administrator. 


Views: The most popular contributed 
module for Drupal, Views gives your site 
substantial new ways to present data. You 
can download it from its project page at 

drupal.org/project/views. 

vocabulary: A category in Drupal’s system 
of taxonomy. If you wanted to categorize 
cars, for example, you could have a 
vocabulary for “transmission type,” which 
would contain the terms “automatic” and 
“manual.” 
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Acquia Drupal 
contents, 13 

DAMP stack installer, 3,8 
downloading, 13 
user-interface audit, 170 
administration emails, 161-162 
Administration module, 203 
administrative overlay, 22 
turning off, 25 

viewing pages with/without, 24 
Advanced Help module, 204 
Aggregator module, 61, 63-66 
Feed aggregator page, 63-66 
all folder in sites folder, 39 
AMP stacks 
DAMP, 3,8 
elements 

Apache web server, 2-3 
MySQL database program, 2-3 
PHP programming language, 2-3 
installing both stack and Drupal, 3 


AMP stacks (continued) 

MAMP 

Apache Ports preferences, 10 
configuring, 9-10 
DocumentRoot folder, 10 
installing, 4-5 

MySQL databases, creating, 15 
MySQL Ports preferences, 10 
Web Sharing conflicts, 9-10 
WAMP, 2 

configuring, 11 
DocumentRoot folder, 11 
installing, 6-7 

MySQL databases, creating, 16 
PHP file size settings, 11 
WampServer,2 
Anello, Michael, 205 
Anonymous users, 154 
Apache web server, 2-3 
localhost, 20 

Ports preferences (MAMP), 10 
appropos copy *nix command, 13 
appropos description *nix command, 13 
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articles, 29, 31 

versus basic pages, 52 
versus blog posts, 62 
elements, 52 
images, 86 
tags, 54 
Atom, 66 


backing up sites 
databases, 45 
installation files, 44 
restoring from backups, 46-47 
Bartik theme, 22, 35 
basic pages 

versus articles, 52 
versus blog posts, 62 
elements, 52 
home (front), 29-30 
Basic theme, 183 
Berry, Addison, 211 
BigDump program, 47 
blocks, 140 
adding, 145 

configuring location and appearance, 
143-145 

moving among/within regions, 141-142 
blog posts, 61-62 

versus articles or basic pages, 62 
book pages, 61 

of linked content, 68-69 
structure, changing, 70 
Boulton, Mark, 170 
Buytaert, Dries, 13, 211 

DrupalCon conference, 85 
entities introduction, 173 
Byron, Angela, 85,155 


c 

CAPTCHA module, 204 

CCK (Content Construction Kit) module, 74, 203 
cd .. *nix command, 12 
cd directory name *nix command, 12 
cd /path/to/location *nix command, 12 
ChatZilla, 219 

Colloquy, Mac IRC client, 219 
command - -help *nix command, 13 
comments 

Comment module, enabling, 99 
responses to nodes, 58 
contact forms, 174-176 
containers, 101-102 

Content Construction Kit (CCK) module, 74, 

203 

content/content types. See also custom 
content/content types; interactive 
content/content types 
articles, 29, 31 

versus basic pages, 52 
versus blog posts, 62 
elements, 52 
images, 86 
basic pages, 31 
versus articles, 52 
versus blog posts, 62 
elements, 52 
home (front), 29-30 
blog posts, 31, 61-62 

versus articles or basic pages, 62 
book pages, 61 

of linked content, 68-69 
structure, changing, 70 
deleting, 71, 80 
editing, 71-72 
filtering, 72 
finding, 71-72 
image styles, 117 
changing, 118 
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content/content types, image styles (continued) 
creating, 119-120 
editing, 119-120 
images 

adding new, 87 
adding to existing nodes, 86 
adding with HTML, 90-91 
in modules, 203-204 
settings, 88-89 
list of content, viewing, 71-72 
news feeds, 63-67 

finding feeds through searches, 66 
nodes 

appearing at top of pages, 60 
author and date, changing, 59 
backing up revisions, 56 
“Create new revision” check box, 56 
editing, 54, 71-72 
hiding, 59 

menu items linking to, 55 
new, 53 

page bodies, 52 
versus pages, 31 

performing changes on multiple, 72 
tracking changes, 56 
URL paths, user-friendly, 57 
user comments, 58 
viewing list, 71-72 
searching 

granting permissions, 123 
indexing content, 123,126 
making content searchable, 122 
Search settings page, 126-127 
simple and advanced, 124-125 
text formats 

adding, 112-115 
changing default, 111 

with HTML, Filtered HTML, 91,110-112,115 
with HTML, Full HTML, 91,110-112,115 


core themes, 34 
cp *nix command, 13 
cron program, 123,126 

Poormanscron module, 204 
cropping images, 119-120 
crowdsourcing, 171 
CSS (Cascading Style Sheets) 

Skinr module, 146 
themes, 185-186 

adding styles to, 186-187 
external styles, 184 
graphics, background, 189-191 
graphics, incidental, 191-192 
importance, 187 
inline styles, 184 
internal styles, 184 
CSS3: Visual OuickStart Guide, 187 
custom content/content types, 74. See also 
content/content types; interactive 
content/content types 
deleting, 80 
fields 

adding, 84 

CCK (Content Construction Kit) module, 
74, 203 

display and input options, 81-83 
new, 75-80 
Cyberduck, 11 

D 

DAMP, 3,8 
dashboard, 23 

databases. See MySQL databases 
Date module, 203 
default folder in sites folder, 39 
desaturating images, 119 

DocumentRoot folder 
MAMP.10 
WAMP,11 

Douglass, Robert, 127 
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Drupal Foundation, 226 
DrupalCamps, 228 
DrupalCon conferences, 85, 228 
Drupal/Drupal 7 

administrative overlay, 22 
turning off, 25 

viewing pages with/without, 24 
contributing, 225 

non-technical support, 226 
technical support, 227 
Dashboard, 23 
customizing, 27 
downloading, 8 
face-to-face opportunities 
Drupal classes, 228 
DrupalCamps, 228 
Drupalcon, 228 

DUGs (Drupal User Groups), 228 
finding employment, 224 
glossary, 229-233 
hiring experts, 220 

checking out at other sources, 223-224 
installing, 17-18 

configuring databases, 18-19 
configuring site, 19-20 
Drupal 7 and AMP stack, 3 
fix of MAMP problem, 5 
modules 

top 20 used, 203-204 
version problems, 197,202 
*nix servers 

transferring to, 11-12 
unpacking on, 12 
requirements 
AMP stack, 2-3 
file transfer program, 2 
Internet connection, 2 
local computer versus server, 3 
text editor, 2 


Drupal/Drupal 7 (continued) 

Shortcut bar, 22 

changing items in, 26 
Toolbar,22 

Drupal/Drupal 7 community, building and 
protecting 

contact forms, 174-176 
profiles 

fields, adding, 172-173 
Profile module, 173 
drupal.org web site 

discussion etiquette, 217 
help 

asking questions, 216 
faceted searches, 214-215 
handbooks, 213 
modules, 216 
Site Building Guide, 213 
themes, 216 

Troubleshooting FAQ, 213,216 
user accounts, 213-214 
DUGs (Drupal User Groups), 228 

E-F 

email addresses, 149,158 

administration, automated, 161-162 
etiquette, discussions, 217 
Feed aggregator page, 63-64 
file transfer protocol programs. See FTP 
FileField module, 203 
FileZilla, 2,11 

Filtered HTML text format, 91,110-112,115 
Firebug, 187,191 
Firefox browser, 187 
ChatZilla, 219 
Flexinode module, 74 
“45 Modules in 45 Minutes,” 205 
“49 Modules You Should Know,”205 
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forums 

Comment and Taxonomy modules,99 
creating, 102 
help, 216 
managing, 103 
multi-level structure, 101 
setting up, 99-100 
Forums vocabulary, 104,105 
front home) pages, 29-30 
promoting nodes to, 60 
front pages. See home (front) pages 
FTP (file transfer protocol) programs 
requirement, 2 

transferring Drupal 7 to *nix servers, 11-12 
Full HTML text format, 91,110-112,115,116 
Fusion theming, 146 

G 

Garland theme, 35 
Genesis theme, 183 
global settings, themes, 37 
glossary, 229-233 

GNU Image Manipulation Program (GIMP), 189 
GNU Public License, 180 
Lullacons Pack 1,192 
modules, 197 

Google Analytics module, 204 
graphics files, themes, 33. See also images 
backgrounds, 189-191 
incidental, 191-192 
gzip files, uncompressing, 8 

H 

Haug, Nate, 192 
help 

drupal.org web site 
asking questions, 216 
faceted searches, 214-215 


help, Drupal.org web site (continued) 
handbooks, 213 
hiring experts, 220 
modules, 216 

one-on-one with IRC, 218-219 
Site Building Guide, 213 
themes, 216 

Troubleshooting FAQ, 213,216 
face-to-face opportunities 
Drupal classes, 228 
DrupalCamps, 228 
Drupalcon, 228 

DUGs (Drupal User Groups), 228 
hierarchical arrangement, menus, 136-137 
home (front) pages, 29-30 
promoting nodes to, 60 
.htaccess hidden file, 46 

I 

Image module, 204 
ImageAPI module, 203 
ImageCache module, 203 
ImageField module, 203 
images. See also graphics files, themes 
adding 

to existing nodes, 86 
with HTML, 90-91 
new, 87 
modules 
Image, 204 
ImageAPI, 203 
ImageCache, 203 
ImageField, 203 
settings, 88-89 
styles, 117 

changing, 118 
creating, 119-120 
editing, 119-120 
user accounts, 152 
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IMCE module, 204 
indexing content 

cron program, 123,126 
periodically, 123 
.info files, themes, 33 
CSS files, 184-186 
duplicating/renaming, 181-183 
graphics files, 189,192 
INSTALL.TXT file,28 

interactive content/content types. See also 
content/content types; custom content/ 
content types 
containers, 101-102 
forums 

Comment and Taxonomy modules, 99 
creating, 102 
managing, 103 
multi-level structure, 101 
setting up, 99-100 
polls 

creating, 96-97 
managing, 98 

taxonomies, categorizing with, 104 
taxonomy vocabulary 
planning on paper, 109 
setting up, 105 
terms, adding, 108-109 
terms, viewing in content, 109 
using, 106-107 
internationalization, 162 
Internet connection, requirement, 2 
ISPs (Internet service providers), MySQL tools 
access, 16 

J-L 

JQuery Ul module, 204 
layout 

blocks, 140 
adding, 145 


layout, blocks (continued) 

configuring location and appearance, 
143-145 

moving among/within regions, 141-142 
panels, 146 
license agreements 

GNU Public License, 180 
core themes, 180 
Lullacons Pack 1,192 
modules, 197 
MAMP, 4-5 
links to menus 

to administration page, 131-133 
deleting, 134 
disabling Secondary, 139 
in Main and User menus, 138 
to nodes, 55,131-133 
URL required, 137 

Linux operating system, *nix servers, 3 
list of content, viewing, 71-72 
local computers versus servers, Drupal 
development, 3 
locale settings, 153 
localhost, 20 

Is -al *nix command, 12-13 
Is *nix command, 12 
Lullacons Pack 1,192 

M 

Macintosh 

Colloquy IRC client, 219 
DAMP, lack of support, 3 
Drupal 7 

downloading, 8 
hidden file, 8 
MAMP, 2 

Apache Ports preferences, 10 
configuring, 9-10 
DocumentRoot folder, 10 
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Macintosh, MAMP (continued) 
installing, 4-5 

MySQL databases, creating, 15 
MySQL Ports preferences, 10 
Web Sharing conflicts, 9-10 
TextEdit, 2 
Main menu, 128-129 

changing link locations, 138 
Delete button, lack of, 134 
disabling, 139 
Maintenance mode, 48 
MAMP, 2 

Apache, Ports preferences, 10 

configuring, 9-10 

DocumentRoot folder, 10 

fix for Drupal installation problem, 5 

installing, 4-5 

MySQL 

creating databases, 15 
Ports preferences, 10 
superuser password, 5 
Web Sharing conflicts, 9-10 
man command *nix command, 13 
Management menu, 128-129 
Delete button, lack of, 134 
menus 

deleting, 134 
links 

to administration page, 131-133 
deleting, 134 
disabling Secondary, 139 
in Main and User menus, 138 
to nodes, 55,131-133 
URL required, 137 
Main menu, 128-129 

changing link locations, 138 
Delete button, lack of, 134 
disabling, 139 

Management menu, 128-129 
Delete button, lack of, 134 


menus (continued) 

Navigation menu, 128-129 
Delete button, lack of, 134 
new, 55,129-130 
rearranging, 135 

in hierarchy, 136-137 
themes vary appearances, 137 
titles, changing, 137 
User menu, 128-129 

changing link locations, 138 
Delete button, lack of, 134 
metadata text files, themes, 33 
Microsoft Internet explorer fix, 185 
Miranda, Windows IRC client, 219 
modules 

administrative overlay, 22 
turning off, 25 

available outside drupal.org web site, 197 
configuring, 195-196 
enabling, 195 
evaluating 

“Comparison of contributed modules” 
page, 209 

past, through issue queues, 206-209 
reading blogs, 205 
Similar Module Review group, 209 
images 

Image, 204 
ImageAPI, 203 
ImageCache, 203 
ImageField, 203 
installing, 194-195 
popular, top 20, 203-204 
turning on, 28 
updating, 198-200 
bug fixes, 201 

improvements/additions, 201 
security fixes, 201 
version availability, 197,202 
modules folder, 39 
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monitoring sites 

system activity, tracking, 41-42 
system issues, correcting, 40 
mv source destination *nix command, 12 
MySQL databases, 2-3 
case sensitivity, 15 
creating with phpMyAdmin, 14 
Mac OS X using MAMP, 15 
*nix with command-line interface, 16 
Windows using WAMP,16 
naming restrictions, 15 
Ports preferences (MAMP), 10 
superuser password 
for MAMP installation, 5 
for WAMP installation, 7 
updating, 199-200 


Navigation menu, 128-129 
Delete button, lack of, 134 
news feeds, 63-67 

finding feeds through searches, 66 
NineSixty theme, 183 
*nix servers, 7 

commands, 12-13 
DAMP, 3,8 
Drupal 7 

database with command-line interface, 16 
transferring to *nix, 11-12 
unpacking on *nix, 12 
XAMPP stack, security warning, 7 
nodes 

appearing at top of pages, 60 

author and date, changing, 59 

backing up revisions, 56 

“Create new revision” check box, 56 

current region, 31 

editing, 54 

hiding, 59 


nodes (continued) 

menu items linking to, 55 
new, 53 

versus page content types, 31 
performing changes on multiple nodes, 72 
promoting to home (front) pages, 60 
tracking changes, 56 
URL paths, user-friendly, 57 
user comments, 58 
viewing list, 71-72 
NoneOne series, modules, 205 
Notepad (Windows), 2 

0 - Q 

Overlay module, 22 

pages. See content/content types; custom 
content/content types; interactive 
content/content types 
panels, 146 
passwords, 149 
Pathauto module, 203 
Permission filter, viewing user accounts, 151 
permissions 
defining, 163 
editing, 164,168 

finding settings for specific modules, 169 
important permissions, 170 
moderating comment spam, 177 
Photoshop, 189 

PHP programming language, 2-3 
file size settings in WAMP,11 
PHP filter, text formats, 110,113,115-116 
phpMyAdmin, MySQL databases 
backing up, 45 
creating, 14 

importing/exporting problems, 47 

for Mac OS X using MAMP,15 

for *nix using command-line interface, 16 

restoring, 46-47 

for Windows using WAMP, 16 
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Planet Drupal, 205 
polls 

creating, 96-97 
managing, 98 

Poormanscron module, 204 
profiles 

fields, adding, 172-173 
Profile module, 173 
programming files, themes, 33 
pwd *nix command, 12-13 

R 

RDF (Resource Description Framework), 66 
README.TXT file, 28 
rearranging, 135 
requirements, Dupral 7 
AMP stack 

Apache web server, 2-3 
MySQL database program, 2-3 
PHP programming language, 2-3 
file transfer program, 2 
Internet connection, 2 
local computer versus server, 3 
text editor, 2 

Role filter, viewing user accounts, 151 
roles, 149,163 

adding/deleting, 164 
administrative users, 164-166 
anonymous users, 164-166 
changing, for individuals, 166 
rotating images, 119-120 
RSS (Really Simple Syndication), 66 

s 

scaling images, 120 
SCP (Secure Copy), 2 
script files, themes, 33 
Secure Copy (SCP), 2 


servers versus local computers, Drupal 
development, 3 
Seven theme, 20, 22 
Shortcut bar 

changing items in, 26 
new in Drupal 7,22 
signatures and avatars, 159-160 
Site Building Guide, 213 
sites folder, 44 

all and default folders, 39 
themes, changing existing, 183 
Skinr module, 146 
slogans, themes, 31 
Status filter, viewing user accounts, 151 
style files, themes, 33 

T 

Tags vocabulary,104 
tags/tagging, 54 
taxonomies 

categorizing with, 104 
vocabulary 

planning on paper, 109 
setting up, 105 
terms, adding, 108-109 
terms, viewing in content, 109 
using, 106-107 
Taxonomy module,99 
Teague, Jason Cranford,187 
text editor, requirement, 2 
text formats 

adding, 112-115 
changing default, 111 

with HTML, Filtered HTML, 91,110-112,115 

with HTML, Full HTML, 91,110-112,115,116 

with HTML tags, 91 

htmILawed module, 110 

with PHP filter, 110,113,115-116 

with rich-tech editor, 92-94 

selecting for individual nodes, 111 
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TextEdit (Mac), 2 
themes 

administration, 22-23 
alternative, downloading and installing, 
38-39 

Bartik, 22, 35 
Basic, 183 
core, 34 

CSS (Cascading Style Sheets), 185-186 
adding styles to, 186-187 
external styles, 184 
graphics, 185 

graphics, background, 189-191 
graphics, incidental, 191-192 
importance, 187 
inline styles, 184 
internal styles, 184 
duplicating, 181-185 
Garland, 35,185 
Genesis, 183 
menu appearances, 137 
new, 180 
NineSixty, 183 
parts, 33 

renaming, 181-184 

versus changing existing theme, 185 
settings, 35-37 
global, 37 
Seven, 20, 22 
slogans, 31 
template files, 185 
Zen, 183 

themes folder, 39 
Token module, 197,203 
Toolbar 

changing items in, 139 
new in Drupal 7,22 
TopNotchThemes,146 
Troubleshooting FAQ, 213,216 


u 

uncompressing gzip files, 8 
Unix: Visual QuickStart Guide, 4th Edition, 13 
Unix/Unix-like operating systems, *nix servers, 
2-3 

updating sites, 48-50 
user accounts 

automated administration emails, 161-162 
canceling, 154-155 
controlling, 156-158 
creating, 148-150 
controlling, 156-158 
email addresses, 149,158 
internationalization, 162 
locale settings, 153 
modifying, 152-153 
notifying of new account, 149 
passwords, 149 

versus people terminology, 150 
permissions 

contact forms, 174-176 
defining, 163 
editing, 164,168 

finding settings for specific modules, 169 
important permissions, 170 
moderating comment spam, 177 
pictures, 152 
profiles 

fields, adding, 172-173 
Profile module, 173 
roles, 149 

adding/deleting, 164 
administrative users, 164-166 
anonymous users, 164-166 
changing, for individuals, 166 
comment spam, 177 
contact forms, 163,174 
signatures and avatars, 159-160 
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user accounts (continued) 
status, 149 
user names, 148 
viewing list of, 151 
User menu, 128-129 

changing link locations, 138 
Delete button, lack of, 134 
user names 
defining, 148 

versus people terminology, 150 

v-w 

Views module, 203 
WAMP.2 

configuring, 11 

DocumentRoot folder, 11 
PHP file size settings, 11 
installing, 6-7 
MySQL 

databases, creating, 16 
superuser password, 7 
WAMP Setup Wizard, 6 
WampServer, 2 

list at http: lien .Wikipedia .org/wiki/ 
Comparison_of_WAMPs, 2 

Web Sharing (Mac) conflicts, 9-10 
web site management 
backing up 
databases, 45 
installation files, 44 
restoring from backups, 46-47 
configuring information, 31-32 
monitoring 

system activity, tracking, 41—42 
system issues, correcting, 40 
moving to another computer, 47 
sites folder, all and default folders, 39 
updating, 48-50 


web sites, helpful information 

accounts, http: 11 domain-name! aAmi.nl 
config/people/accounts, 36 
Acquia Drupal, acquia.com/downloads, 3,13 
AMP stacks 

acquia.com/downloads, 3 
apachefriends.org/en/xampp.html, 7 
list at http: //en.wikipedia .org/wiki/ 
Comparison_of JaIAMPs, 2 
mamp.info, 2, 4 
sourceforge.net, 6 
wampserver.com/en/, 2, 6 
BigDump program, http://ozerov.de/ 
bigdump.php, 47 
blog posts 

http: I/domain-name!blog, 62 

http:/ /domain-name! blog/ user-ID, 62 

contributing 

drupal.org/contribute, 224 
drupal.org/contribute/development, 227 
drupal.org/contribute/documentation, 

226 

drupal.org/contribute/marketing, 226 
drupal.org/contribute/testing, 226 
drupal.org/contribute/translations, 

226 

http://lists.drupal.org/listinfo/ 
support, 226 

CSS (Cascading Style Sheets) 
w3schools.com/css,187 
w3schools.com/css/css_background.asp, 

189 

databases, http://drupal.org/node/8l995, 
47 

Drupai Foundation, http://association. 

drupal.org, 226 
Drupal/Drupal 7 

cyrve.com/d7cx, 202 
drupal.org, 13 
drupal.org/node/43816, 39 
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web sites, Drupal/Drupal 7 (continued) 

drupal.org/project/drupal, 8 
drupal.org/project/issues/project 
-name, 217 

drupal.org/project/usage, 202 
drupal.org/Troubleshooting-FAQ, 213 
http :/ /domain-name/u pdate.php, 49 
/sites/default/settings.php, 47 
events, http:/ /groups.drupal.org/events, 
228 

Firebug, getfirebug.com, 187,191 
forums, http:// domain-name /forum, 101 
FTP 

cyberduck.ch, 11 
filezilla-project.org, 2,11 
winscp.net, 11 

GNU Public License, gnu.org/copyleft/ 
gpl.html, 180 

help 

drupal.org/forum, 216 
drupal.org/Troubleshooting-FAQ, 213 
internationalization, http:/ /groups.drupal. 

org/il8n, 162 
IRC connections 

drupal.org/irc, 218 
http://webchat.freenode.net, 218 
job hunting, groups.drupal.org/jobs, 224 
menu links, drupal.org/project/views, 131 
modules 

drupalmodules.com,197 
drupal.org/project/modules, 28,193 
drupal.org/project/token,197 
http: t / domain-name /article-about 

-bears#overlay=admin/modules, 25 
http://localhost/admin/modules, 25 
modules, evaluating 

drupal.org/node/266179, 209 
drupal.org/project/issues/module 
-name, 206, 208 


drupal.org/project/issues/statistics/ 
module-name, 201 

drupal.org/project /module-name, 216 
groups.drupal.org/similar-module 
-review, 209 

nodeone.se/blogg/49-modules-you 
-should-know, 205 

MySQL superuser password, udopage.com/ 
developers/setting-up-passwords 
-for-wamp.php, 7 

new accounts, http: // domainname/user/ 
register, 156 

news feeds, savemyhomebook.com, 66 
Node 8, webchick.net/contributor- 
spotlight/daniel-kudwien,155 
panels, drupal.org/project/panels, 146 

search options 

http://domoi/7-nome/search, 124 
lullabot.com/articles/drupals_search 
_module_and_scoring_factors,127 

text formats 

drupal.org/handbook/customization/ 
php-snippets, 116 
drupal.org/project/htmLawed, 110 

themes 

drupal.org/project/basic,183 
drupal.org/project/genesis,183 
drupal.org/project/ninesixty,183 
drupal.org/project/themes, 34, 38, 
180-181 

drupal.org/project/zen,183 
drupal.org/theme-guide,179,184 
fusiondrupalthemes.com,146 
topnotchthemes.com, 146 
uncompressing gzip files 

stuffit.com/win-expander.html, 8 
technelysium.com.au/winimp.html, 8 
winace.com, 8 
winzip.com, 8 
Webform module, 204 
Weitzman, Moshe, 202 
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Windows 
Drupal 7 

downloading, 8 
uncompressing gzip files, 8 
Miranda IRC client, 219 
Notepad, 2 
WAMP.2 

configuring, 11 
DocumentRoot folder, 11 
installing, 6-7 

MySQL databases, creating, 16 
PHP file size settings, 11 
WinSCP.11 


x-z 

XAMPP.7 
Zen theme, 183 


Index 247 





Meet Creative Edge. 

A new resource of unlimited 
books, videos and tutorials for 
creatives from the world's 
leading experts. 

Creative Edge is your one 
stop for inspiration, answers to 
technical questions and ways to 
stay at the top of your game so 
you can focus on what you do 
best—being creative. 

All for only $24.99 per month 
for access—any day any time 
you need it. 

creative 

edge 


peachpit.com/creativeedge 



